Products

List available products

GET/v2/productsTry it

Returns the list of product models available, read from the database. This is the authoritative source for the productId values used when creating an order or calculating shipping rates. With include=prices, each model also carries price: what one printed card of it costs the authenticated account under its plan, excluding VAT and shipping (null when the plan does not price that model, or the account has no plan usable by this caller). It is priced as this caller's orders are, so a shop integration can use it as the product's cost; an order of several cards can fall into a cheaper tier of the plan, and its exact amount is given by the order quote.

Request

Authorization

Bearer token

Send your API key in the Authorization header: Authorization: Bearer sk_test_…. A sk_test_ key creates and sees test orders only. Keys and test mode.

Query parameters
  • includestring: prices
    prices adds the account's price of one printed card to each model.

Responses

200Successfully retrieved available models
  • successboolean
  • modelsarray of Product
401Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (INVALID_TOKEN)

Type: Error

403The API key is inactive or revoked (INACTIVE_API_KEY), or targets another account (ACCOUNT_ACCESS_DENIED, refused once the account guard is enforced); with an OAuth access token: a token of scope mcp (INSUFFICIENT_SCOPE), a path naming another account or a person no longer a member of it (ACCOUNT_ACCESS_DENIED), a real token on the sandbox host (SANDBOX_REQUIRES_TEST_KEY)

Type: Error

429
500Server error

Type: Error

Request
curl -X GET "https://api.printags.com/v2/products" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY"
Response 200
{
  "success": true,
  "models": [
    {
      "id": "ntag424_pvccard_white",
      "size": {
        "width": 0,
        "height": 0,
        "length": 0,
        "weight": 6
      },
      "prices": [],
      "canBeEncoded": true,
      "price": {
        "currency": "eur",
        "quantity": 1,
        "unitPriceExclVat": 2.1
      }
    }
  ]
}