Retrieve up to 100 trademarks

Retrieve up to 100 full trademark records by id in one call.

POST /v1/trademarks/batch

cURL

curl "https://api.pinakelai.com/v1/trademarks/batch" \
  -H "Authorization: Bearer $PINAKEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba", "tm_AL_01380b37-3212-5fc1-8cce-20183f7c15eb", "tm_AL_no-such-record"]}'

200

{
  "object": "list",
  "data": [
    {
      "object": "trademark",
      "id": "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba",
      "jurisdiction": "AD",
      "office": "AD",
      "origin_office": null,
      "identifiers": {
        "application_number": "48000",
        "registration_number": "48000",
        "international_registration_numbers": [],
        "priority_claims": []
      },
      "mark": {
        "text": "NOKY",
        "translation": null,
        "transliteration": null,
        "feature": "word",
        "kind": "individual"
      },
      "status": {
        "value": "registered",
        "category": "live",
        "date": "2009-06-05",
        "office_status": null,
        "office_status_code": null
      },
      "dates": {
        "application": "2009-06-05",
        "registration": "2009-06-05",
        "publication": "2025-07-28",
        "expiry": "2029-06-05",
        "renewal": null,
        "termination": null,
        "opposition_period_end": null
      },
      "classification": {
        "nice_classes": [8, 16, 21],
        "national_classes": [],
        "similar_group_codes": [],
        "vienna_codes": []
      },
      "parties": {
        "owners": [
          {
            "name": "ESSITY PLD FRANCE SAS",
            "name_translated": null,
            "name_key": "ESSITY PLD FRANCE",
            "country": null,
            "address": "BOULEVARD VICTOR-HUGO, CS 80047, 151, POSTAL CODE: 93400, CITY: SAINT-OUEN, FRANCE",
            "entity": "SAS",
            "roles": ["owner", "applicant"]
          }
        ],
        "representatives": [
          {
            "name": "JOSEP CARBONELL GIMENO",
            "name_translated": null,
            "name_key": "JOSEP CARBONELL GIMENO",
            "country": "AD",
            "address": "C. Bonaventura Riberaygua, 39, 4t - 3a Andorra la Vella",
            "entity": null,
            "roles": ["representative"]
          }
        ]
      },
      "designated_countries": [],
      "media": {
        "has_image": false
      },
      "updated_at": "2026-11-10T09:02:13.512000Z",
      "source": {
        "processed_on": "2026-11-10"
      },
      "links": {
        "self": "https://api.pinakelai.com/v1/trademarks/tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba"
      }
    },
    {
      "object": "trademark",
      "id": "tm_AL_01380b37-3212-5fc1-8cce-20183f7c15eb",
      "jurisdiction": "AL",
      "office": "AL",
      "origin_office": null,
      "identifiers": {
        "application_number": "AL/T/2026/001305",
        "registration_number": null,
        "international_registration_numbers": [],
        "priority_claims": []
      },
      "mark": {
        "text": null,
        "translation": null,
        "transliteration": null,
        "feature": "figurative",
        "kind": "individual"
      },
      "status": {
        "value": "pending",
        "category": "live",
        "date": null,
        "office_status": "Në proces ekzaminimi",
        "office_status_code": null
      },
      "dates": {
        "application": "2026-10-05",
        "registration": null,
        "publication": null,
        "expiry": null,
        "renewal": null,
        "termination": null,
        "opposition_period_end": null
      },
      "classification": {
        "nice_classes": [9, 35, 36, 42],
        "national_classes": [],
        "similar_group_codes": [],
        "vienna_codes": []
      },
      "parties": {
        "owners": [
          {
            "name": "CONAD-CONSORZIO NAZ. DETTAGLIANTI SOC.COOPERATIVA IN SIGLA CONAD",
            "name_translated": null,
            "name_key": "CONAD CONSORZIO NAZ DETTAGLIANTI SOCCOOPERATIVA IN SIGLA CONAD",
            "country": "IT",
            "address": "VIA MICHELINO, 59 40127 Bolonja, Itali",
            "entity": null,
            "roles": ["applicant"]
          }
        ],
        "representatives": [
          {
            "name": "RENATA LEKA",
            "name_translated": null,
            "name_key": "RENATA LEKA",
            "country": "AL",
            "address": "Njesia bashkiake nr 5, rruga Ibrahim Rugova, Kompleksi Green Park, kulla 1, kati 3,Tirane , AL",
            "entity": null,
            "roles": ["representative"]
          }
        ]
      },
      "designated_countries": [],
      "media": {
        "has_image": true
      },
      "updated_at": "2026-11-10T09:02:13.512000Z",
      "source": {
        "processed_on": "2026-11-10"
      },
      "links": {
        "self": "https://api.pinakelai.com/v1/trademarks/tm_AL_01380b37-3212-5fc1-8cce-20183f7c15eb"
      }
    }
  ],
  "not_found": ["tm_AL_no-such-record"],
  "unavailable": []
}

Returns full trademark records for up to 100 ids in one call, in the order you sent them. The request is read-only; POST only carries the list of ids.

• Body: {"ids": [...], "include": [...]}, as application/json, at most 64 KB. Anything else gets 415 or 413.
• ids: 1 to 100 record ids. Duplicates are removed; the first occurrence keeps its place.
• include: optional, the same values as retrieve. With goods_services, assignments or source_record, at most 25 ids.
• Ids that do not exist are listed in not_found. Ids whose register is reloading, or whose record cannot be assembled right now, are listed in unavailable; retry those later. Both lists hold the ids as you sent them.
• One batch counts as one call, whatever the number of ids.

cURL

curl "https://api.pinakelai.com/v1/trademarks/batch" \
  -H "Authorization: Bearer $PINAKEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ids": ["tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba", "tm_AL_01380b37-3212-5fc1-8cce-20183f7c15eb", "tm_AL_no-such-record"]}'

200

{
  "object": "list",
  "data": [
    {
      "object": "trademark",
      "id": "tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba",
      "jurisdiction": "AD",
      "office": "AD",
      "origin_office": null,
      "identifiers": {
        "application_number": "48000",
        "registration_number": "48000",
        "international_registration_numbers": [],
        "priority_claims": []
      },
      "mark": {
        "text": "NOKY",
        "translation": null,
        "transliteration": null,
        "feature": "word",
        "kind": "individual"
      },
      "status": {
        "value": "registered",
        "category": "live",
        "date": "2009-06-05",
        "office_status": null,
        "office_status_code": null
      },
      "dates": {
        "application": "2009-06-05",
        "registration": "2009-06-05",
        "publication": "2025-07-28",
        "expiry": "2029-06-05",
        "renewal": null,
        "termination": null,
        "opposition_period_end": null
      },
      "classification": {
        "nice_classes": [8, 16, 21],
        "national_classes": [],
        "similar_group_codes": [],
        "vienna_codes": []
      },
      "parties": {
        "owners": [
          {
            "name": "ESSITY PLD FRANCE SAS",
            "name_translated": null,
            "name_key": "ESSITY PLD FRANCE",
            "country": null,
            "address": "BOULEVARD VICTOR-HUGO, CS 80047, 151, POSTAL CODE: 93400, CITY: SAINT-OUEN, FRANCE",
            "entity": "SAS",
            "roles": ["owner", "applicant"]
          }
        ],
        "representatives": [
          {
            "name": "JOSEP CARBONELL GIMENO",
            "name_translated": null,
            "name_key": "JOSEP CARBONELL GIMENO",
            "country": "AD",
            "address": "C. Bonaventura Riberaygua, 39, 4t - 3a Andorra la Vella",
            "entity": null,
            "roles": ["representative"]
          }
        ]
      },
      "designated_countries": [],
      "media": {
        "has_image": false
      },
      "updated_at": "2026-11-10T09:02:13.512000Z",
      "source": {
        "processed_on": "2026-11-10"
      },
      "links": {
        "self": "https://api.pinakelai.com/v1/trademarks/tm_AD_2376e41e-3d24-57e3-af6f-6a176f9985ba"
      }
    },
    {
      "object": "trademark",
      "id": "tm_AL_01380b37-3212-5fc1-8cce-20183f7c15eb",
      "jurisdiction": "AL",
      "office": "AL",
      "origin_office": null,
      "identifiers": {
        "application_number": "AL/T/2026/001305",
        "registration_number": null,
        "international_registration_numbers": [],
        "priority_claims": []
      },
      "mark": {
        "text": null,
        "translation": null,
        "transliteration": null,
        "feature": "figurative",
        "kind": "individual"
      },
      "status": {
        "value": "pending",
        "category": "live",
        "date": null,
        "office_status": "Në proces ekzaminimi",
        "office_status_code": null
      },
      "dates": {
        "application": "2026-10-05",
        "registration": null,
        "publication": null,
        "expiry": null,
        "renewal": null,
        "termination": null,
        "opposition_period_end": null
      },
      "classification": {
        "nice_classes": [9, 35, 36, 42],
        "national_classes": [],
        "similar_group_codes": [],
        "vienna_codes": []
      },
      "parties": {
        "owners": [
          {
            "name": "CONAD-CONSORZIO NAZ. DETTAGLIANTI SOC.COOPERATIVA IN SIGLA CONAD",
            "name_translated": null,
            "name_key": "CONAD CONSORZIO NAZ DETTAGLIANTI SOCCOOPERATIVA IN SIGLA CONAD",
            "country": "IT",
            "address": "VIA MICHELINO, 59 40127 Bolonja, Itali",
            "entity": null,
            "roles": ["applicant"]
          }
        ],
        "representatives": [
          {
            "name": "RENATA LEKA",
            "name_translated": null,
            "name_key": "RENATA LEKA",
            "country": "AL",
            "address": "Njesia bashkiake nr 5, rruga Ibrahim Rugova, Kompleksi Green Park, kulla 1, kati 3,Tirane , AL",
            "entity": null,
            "roles": ["representative"]
          }
        ]
      },
      "designated_countries": [],
      "media": {
        "has_image": true
      },
      "updated_at": "2026-11-10T09:02:13.512000Z",
      "source": {
        "processed_on": "2026-11-10"
      },
      "links": {
        "self": "https://api.pinakelai.com/v1/trademarks/tm_AL_01380b37-3212-5fc1-8cce-20183f7c15eb"
      }
    }
  ],
  "not_found": ["tm_AL_no-such-record"],
  "unavailable": []
}

Authorizations

Authorization · string · header · required

Your API key: Authorization: Bearer pk_live_... (or pk_test_...).

Body

application/json

OpenAPI schema of the batch body. parse_batch() is the validator.

ids · string[] · required

Up to 100 trademark ids (25 with goods_services, assignments or source_record), as returned in id. Duplicates are answered once.

Required array length: 1 - 100 elements

include · enum<string>[]

Optional parts to add to every object: goods_services, previous_parties, assignments (with securities), source_record.

Available options: goods_services, previous_parties, assignments, source_record

Response

200

application/json

Successful Response

object · string · required

Allowed value: "list"

data · Trademark · object[] · required

Show child attributes

not_found · string[] · required

unavailable · string[] · required