Product certifications

List product certifications

Scopes

• certifications:read

Parameters

• cursorquerystring
• limitqueryinteger
• qquerystringFull-text search on names and titles.
• statusquerypending | no_expiry | valid | expiring | expired | renewed | archived

Responses

• 200OK
  ProductCertificationPageFields (2)

  • dataarray of ProductCertificationRequired
  • next_cursorstring | nullRequiredPass as cursor for the next page; null on the last page.
• 401Missing, revoked, or expired API key.
• 403The key lacks the scope.
• 429Rate limited: 60 requests per minute per key.

Create

Scopes

• certifications:write

Parameters

• Idempotency-KeyheaderstringRequiredStored 24 h per company and key. Same key with a different body returns 422.

Request body

Responses

• 201Created
  ProductCertificationFields (21)

  • idstring
  • versionintegerIncrements on every write. Send it back in If-Match.
  • created_atstring (date-time)
  • updated_atstring (date-time)
  • deleted_atstring | null
  • external_idstring | nullYour system's id, unique per company.
  • statuspending | no_expiry | valid | expiring | expired | renewed | archived
  • product_idstringRequired
  • supplier_idstring | null
  • scopeproduct | whole_plant | endorsementRequired
  • certification_numberstringRequired
  • halal_scheme_idstringRequired
  • issuing_countrystringRequiredISO 3166-1 alpha-2.
  • lifecyclepending | active | renewed | archived
  • start_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • end_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • renewal_of_idstring | null
  • next_renewal_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • cert_code_numberstring | null
  • halal_mark_usedboolean
  • reminder_daysarray of integer | nullDays before end_date to remind; replaces the category rule and the default. Null follows them.
• 400Validation failed.
• 409Version conflict, external_id taken, or a secret that cannot be replayed.
• 422Semantically invalid, or an Idempotency-Key reused with a different body.
• 401Missing, revoked, or expired API key.
• 403The key lacks the scope.
• 429Rate limited: 60 requests per minute per key.

Get

Scopes

• certifications:read

Parameters

• idpathstringRequired

Responses

• 200OK
  ProductCertificationFields (21)

  • idstring
  • versionintegerIncrements on every write. Send it back in If-Match.
  • created_atstring (date-time)
  • updated_atstring (date-time)
  • deleted_atstring | null
  • external_idstring | nullYour system's id, unique per company.
  • statuspending | no_expiry | valid | expiring | expired | renewed | archived
  • product_idstringRequired
  • supplier_idstring | null
  • scopeproduct | whole_plant | endorsementRequired
  • certification_numberstringRequired
  • halal_scheme_idstringRequired
  • issuing_countrystringRequiredISO 3166-1 alpha-2.
  • lifecyclepending | active | renewed | archived
  • start_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • end_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • renewal_of_idstring | null
  • next_renewal_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • cert_code_numberstring | null
  • halal_mark_usedboolean
  • reminder_daysarray of integer | nullDays before end_date to remind; replaces the category rule and the default. Null follows them.
• 404Not found. Records of other companies are also reported as not found.
• 401Missing, revoked, or expired API key.
• 403The key lacks the scope.
• 429Rate limited: 60 requests per minute per key.

Update (partial)

Scopes

• certifications:write

Parameters

• idpathstringRequired
• Idempotency-Keyheaderstring
• If-MatchheaderintegerThe version you last read; 409 version_conflict when it changed.

Request body

Responses

• 200OK
  ProductCertificationFields (21)

  • idstring
  • versionintegerIncrements on every write. Send it back in If-Match.
  • created_atstring (date-time)
  • updated_atstring (date-time)
  • deleted_atstring | null
  • external_idstring | nullYour system's id, unique per company.
  • statuspending | no_expiry | valid | expiring | expired | renewed | archived
  • product_idstringRequired
  • supplier_idstring | null
  • scopeproduct | whole_plant | endorsementRequired
  • certification_numberstringRequired
  • halal_scheme_idstringRequired
  • issuing_countrystringRequiredISO 3166-1 alpha-2.
  • lifecyclepending | active | renewed | archived
  • start_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • end_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • renewal_of_idstring | null
  • next_renewal_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • cert_code_numberstring | null
  • halal_mark_usedboolean
  • reminder_daysarray of integer | nullDays before end_date to remind; replaces the category rule and the default. Null follows them.
• 400Validation failed.
• 404Not found. Records of other companies are also reported as not found.
• 409Version conflict, external_id taken, or a secret that cannot be replayed.
• 422Semantically invalid, or an Idempotency-Key reused with a different body.
• 401Missing, revoked, or expired API key.
• 403The key lacks the scope.
• 429Rate limited: 60 requests per minute per key.

Delete (soft; restorable for 30 days)

Scopes

• certifications:write

Parameters

• idpathstringRequired
• Idempotency-Keyheaderstring

Responses

• 204Deleted
• 404Not found. Records of other companies are also reported as not found.
• 401Missing, revoked, or expired API key.
• 403The key lacks the scope.
• 429Rate limited: 60 requests per minute per key.

Restore within 30 days of deletion

Scopes

• certifications:write

Parameters

• idpathstringRequired
• Idempotency-Keyheaderstring

Responses

• 200OK
  ProductCertificationFields (21)

  • idstring
  • versionintegerIncrements on every write. Send it back in If-Match.
  • created_atstring (date-time)
  • updated_atstring (date-time)
  • deleted_atstring | null
  • external_idstring | nullYour system's id, unique per company.
  • statuspending | no_expiry | valid | expiring | expired | renewed | archived
  • product_idstringRequired
  • supplier_idstring | null
  • scopeproduct | whole_plant | endorsementRequired
  • certification_numberstringRequired
  • halal_scheme_idstringRequired
  • issuing_countrystringRequiredISO 3166-1 alpha-2.
  • lifecyclepending | active | renewed | archived
  • start_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • end_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • renewal_of_idstring | null
  • next_renewal_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • cert_code_numberstring | null
  • halal_mark_usedboolean
  • reminder_daysarray of integer | nullDays before end_date to remind; replaces the category rule and the default. Null follows them.
• 404Not found. Records of other companies are also reported as not found.
• 401Missing, revoked, or expired API key.
• 403The key lacks the scope.
• 429Rate limited: 60 requests per minute per key.

Create or replace by your external id

Scopes

• certifications:write

Parameters

• external_idpathstringRequired
• Idempotency-Keyheaderstring
• If-MatchheaderintegerThe version you last read; 409 version_conflict when it changed.

Request body

Responses

• 200Updated
  ProductCertificationFields (21)

  • idstring
  • versionintegerIncrements on every write. Send it back in If-Match.
  • created_atstring (date-time)
  • updated_atstring (date-time)
  • deleted_atstring | null
  • external_idstring | nullYour system's id, unique per company.
  • statuspending | no_expiry | valid | expiring | expired | renewed | archived
  • product_idstringRequired
  • supplier_idstring | null
  • scopeproduct | whole_plant | endorsementRequired
  • certification_numberstringRequired
  • halal_scheme_idstringRequired
  • issuing_countrystringRequiredISO 3166-1 alpha-2.
  • lifecyclepending | active | renewed | archived
  • start_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • end_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • renewal_of_idstring | null
  • next_renewal_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • cert_code_numberstring | null
  • halal_mark_usedboolean
  • reminder_daysarray of integer | nullDays before end_date to remind; replaces the category rule and the default. Null follows them.
• 201Created
  ProductCertificationFields (21)

  • idstring
  • versionintegerIncrements on every write. Send it back in If-Match.
  • created_atstring (date-time)
  • updated_atstring (date-time)
  • deleted_atstring | null
  • external_idstring | nullYour system's id, unique per company.
  • statuspending | no_expiry | valid | expiring | expired | renewed | archived
  • product_idstringRequired
  • supplier_idstring | null
  • scopeproduct | whole_plant | endorsementRequired
  • certification_numberstringRequired
  • halal_scheme_idstringRequired
  • issuing_countrystringRequiredISO 3166-1 alpha-2.
  • lifecyclepending | active | renewed | archived
  • start_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • end_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • renewal_of_idstring | null
  • next_renewal_datestring | nullCalendar date in the organization's timezone (YYYY-MM-DD).
  • cert_code_numberstring | null
  • halal_mark_usedboolean
  • reminder_daysarray of integer | nullDays before end_date to remind; replaces the category rule and the default. Null follows them.
• 400Validation failed.
• 409Version conflict, external_id taken, or a secret that cannot be replayed.
• 422Semantically invalid, or an Idempotency-Key reused with a different body.
• 401Missing, revoked, or expired API key.
• 403The key lacks the scope.
• 429Rate limited: 60 requests per minute per key.

List the company's enabled halal schemes

Scopes

• certifications:read

Responses

• 200OK
  HalalSchemePageFields (2)

  • dataarray of HalalSchemeRequired
  • next_cursorstring | nullRequiredPass as cursor for the next page; null on the last page.
• 401Missing, revoked, or expired API key.
• 403The key lacks the scope.
• 429Rate limited: 60 requests per minute per key.

Link a document

Scopes

• certifications:write
• documents:read

Parameters

• idpathstringRequired
• document_idpathstringRequired
• Idempotency-Keyheaderstring

Responses

• 204Linked
• 404Not found. Records of other companies are also reported as not found.
• 401Missing, revoked, or expired API key.
• 403The key lacks the scope.
• 429Rate limited: 60 requests per minute per key.

Unlink a document

Scopes

• certifications:write
• documents:read

Parameters

• idpathstringRequired
• document_idpathstringRequired
• Idempotency-Keyheaderstring

Responses

• 204Unlinked
• 404Not found. Records of other companies are also reported as not found.
• 401Missing, revoked, or expired API key.
• 403The key lacks the scope.
• 429Rate limited: 60 requests per minute per key.