Developers · API Reference

Identification ID API

A simple REST API to read your product registry, verify products, and pull live stats. JSON responses, one X-API-Key header.

Get API access →View plans

Getting started

  1. 1Register & choose a plan. Create a manufacturer account and pick a plan that includes API access (Best Value or Enterprise).
  2. 2Create an API key. In your dashboard, open API Access and generate a key. It's shown once — store it securely.
  3. 3Call the API. Send your key in the X-API-Key header on every request. That's it.

Base URL

All endpoints are relative to:

https://api.identificationid.com/api/v1/partner/v1

All responses are JSON with the shape { "success": true, "data": … }.

Authentication

Pass your API key in the X-API-Key header on every request. Keys look like iid_live_… and can be revoked anytime from your dashboard.

Example request
curl https://api.identificationid.com/api/v1/partner/v1/stats \
  -H "X-API-Key: iid_live_your_key_here"

A missing or invalid key returns 403 (see Errors).

List products

GET/products

Returns every product registered by your company, newest first.

Query parameters

statusOptional. Filter by published, draft, or hidden.
Request
curl "https://api.identificationid.com/api/v1/partner/v1/products?status=published" \
  -H "X-API-Key: iid_live_…"
Response 200
{
  "success": true,
  "data": [
    {
      "identification_id": "IID-4F9A-2K7Q",
      "name": "ProChef Air Fryer 5.5L",
      "category": "kitchen_appliances",
      "brand": "ACME",
      "model": "AF-550",
      "status": "published",
      "view_count": 128,
      "published_at": "2026-04-19T10:00:00+00:00",
      "created_at": "2026-04-01T09:00:00+00:00"
    }
  ]
}

Get a product

GET/products/{identification_id}

Full detail for one of your products, including images and every language translation.

Request
curl https://api.identificationid.com/api/v1/partner/v1/products/IID-4F9A-2K7Q \
  -H "X-API-Key: iid_live_…"
Response 200
{
  "success": true,
  "data": {
    "identification_id": "IID-4F9A-2K7Q",
    "name": "ProChef Air Fryer 5.5L",
    "category": "kitchen_appliances",
    "brand": "ACME",
    "model": "AF-550",
    "country_of_origin": "US",
    "status": "published",
    "view_count": 128,
    "published_at": "2026-04-19T10:00:00+00:00",
    "created_at": "2026-04-01T09:00:00+00:00",
    "images": [
      { "url": "https://…/photo.jpg", "alt_text": "Main view", "display_order": 0 }
    ],
    "translations": [
      {
        "lang": "en",
        "short_description": "Large 5.5L digital air fryer.",
        "full_description": "…",
        "usage_instructions": "…"
      }
    ]
  }
}

Verify / lookup

GET/lookup/{identification_id}

Verify that any published product is authentic and see which manufacturer owns it. Great for anti-counterfeit checks.

Request
curl https://api.identificationid.com/api/v1/partner/v1/lookup/IID-4F9A-2K7Q \
  -H "X-API-Key: iid_live_…"
Response 200
{
  "success": true,
  "data": {
    "identification_id": "IID-4F9A-2K7Q",
    "name": "ProChef Air Fryer 5.5L",
    "category": "kitchen_appliances",
    "brand": "ACME",
    "model": "AF-550",
    "country_of_origin": "US",
    "published_at": "2026-04-19T10:00:00+00:00",
    "manufacturer": "ACME Corp",
    "verified": true
  }
}

Stats

GET/stats

Aggregate counts for your company.

Request
curl https://api.identificationid.com/api/v1/partner/v1/stats \
  -H "X-API-Key: iid_live_…"
Response 200
{
  "success": true,
  "data": {
    "total_products": 12,
    "published": 9,
    "total_views": 384
  }
}

Errors

Errors return the matching HTTP status and a JSON body:

Error body
{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "Invalid API key",
    "details": {}
  }
}
403FORBIDDENMissing or invalid X-API-Key
404NOT_FOUNDNo product with that Identification ID
429RATE_LIMITEDToo many requests — slow down

Ready to build?

API access is included with the Best Value and Enterprise plans. Register, choose a plan, and generate your first key in seconds.

Get startedCompare plans