API V2

v2 OAS 3.0
/swagger/api/v2/swagger.json

Getting Started

WilcomStock's API provides direct access to our content library and powerful AI driven search. Integrate the API into your website or platform to allow clients to view and download royalty free embroidery machine file format.

Looking for more details: Visit our API landing page for an overview of the features and to request access.
Support: If you have questions or need help, please contact our support team.

Authentication Authorization: Bearer YOUR_SECRET_KEY

Account

GET /v2/{public_key}/account/info General info about account quotas

Returns general information about the account, including current quota usage and limits.

Parameters
Name Description
public_key * required
string
(path)
Your API Public Key.
months
integer
(query)
minimum: 1
maximum: 6
Number of months of call info
Default value: 1
Responses
200 Success
No links
Media type 
{
  "current": {
    "general": {
      "call_count": 0,
      "call_limit": 0,
      "hard_limit": 0
    },
    "download": {
      "call_count": 0,
      "call_limit": 0,
      "hard_limit": 0
    }
  },
  "history": [
    {
      "month": "string",
      "general": {
        "call_count": 0
      },
      "download": {
        "call_count": 0
      }
    }
  ]
}
401 Unauthorized
No links
Media type 
{
  "errors": [
    {
      "message": "string"
    }
  ]
}
GET /v2/{public_key}/account/licenses Licenses for previously downloaded resources

Retrieves a list of licenses for resources previously downloaded by this account.

SSO & Shared Login

Use these endpoints to allow your users to log in to your site using their WilcomStock credentials.
WEB /sso/authorize Initiate SSO Login flow

Redirect your users to this URL to start the login process.

https://api.wilcomstock.com/sso/authorize?app_id=YOUR_PUBLIC_KEY&redirect_uri=YOUR_URL

WilcomStock will redirect the user back to your URL with a sso_token parameter.

POST /v2/sso/verify Verify SSO token and get user data

After redirection, call this API from your server to exchange the token for user details.

Request Body (JSON):
{
  "sso_token": "RECEIVED_TOKEN",
  "secret_key": "YOUR_SECRET_KEY"
}
Response:
{
  "success": true,
  "user": {
    "id": 1,
    "username": "johndoe",
    "email": "[email protected]",
    "firstname": "John",
    "lastname": "Doe",
    "image": "https://...",
    "country": "United States",
    "mobile": "123456789"
  }
}

Resources

GET /v2/{public_key}/resources/{id} Retrieves a resource

Get detailed information about a specific resource by its ID.

GET /v2/{account_id}/resources/{id}/download Retrieves the download url for a resource

Generates a temporary download URL for the specified resource.

GET /v2/{account_id}/resources/{id}/download_status Retrieves the status for a resized resource

Check the status of a download processing request.

GET /v2/{public_key}/resources Retrieves resources matching filters

Schemas

error
errors_map
resource_download