Certification

Represents certification records awarded to a company, either at the organisation, location or product (type) level.

The certification Object

Certifications store information about standards compliance, certification bodies, validity periods, and the covered entities (organisations, locations, products).

Field Name	Type	Description
id	uuid	Primary key for the certification.
user_created	object	User who created the certification. Read-only. Links to directus_users.
date_created	datetime	Timestamp in ISO 8601 when the certification was created. Read-only.
user_updated	object	User who last updated the certification. Read-only. Links to directus_users.
date_updated	datetime	Timestamp in ISO 8601 when the certification was last updated. Read-only.
certification_agency	string	Name of the certifying agency or body.
certification_agency_url	string	URL for the certifying agency.
certification_start_date	string	Date the certification became valid (ISO 8601 date, e.g., "2024-05-02").
certification_end_date	string	Date the certification expires (ISO 8601 date).
initial_certification_date	string	Date the certification was first granted (ISO 8601 date).
certification_audit_date	string	Date of the most recent audit (ISO 8601 date).
certification_identification	string	Unique identifier or certificate number assigned by the certifying body.
certification_standard	string	Name of the standard or program being certified (e.g., "USDA Organic").
certification_statement	string	Full text of the certification statement.
certification_status	string	Current status of the certification (e.g., "ACTIVE", "EXPIRED").
certification_type	string	Type or category of the certification (e.g., "Organic", "Fair Trade").
certification_uri	string	URL to verify the certification with the issuing agency.
certification_value	string	Outcome or result value of the certification (e.g., "PASSED").
primary_attachment	object	Primary supporting document for the certification. Links to directus_files.
account	object	Account associated with this certification. (Multi-tenant installations only)
covered_locations	array of objects	Locations covered by this certification.
covered_organisations	array of objects	Organisations covered by this certification.
covered_products	array of objects	Products covered by this certification.

---

Sub-Objects

User Object (user_created, user_updated)

See Users for the full schema.

Account Object (account)

See Account for the full schema.

File Object (primary_attachment)

See Files for the full schema.

---

List Certifications

List existing certifications.

REST

GET /items/certification

GraphQL

query {
  certification {
    id
    certification_agency
    certification_standard
    certification_type
    certification_status
    certification_start_date
    certification_end_date
    certification_identification
  }
}

Query Parameters

Supports all global query parameters.

Returns

An array of up to limit certification objects. If no items are available, data will be an empty array.

---

Retrieve a Certification

Retrieve a specific certification by ID.

REST

GET /items/certification/:id

GraphQL

query {
  certification_by_id(id: "certification_id") {
    id
    certification_agency
    certification_agency_url
    certification_start_date
    certification_end_date
    initial_certification_date
    certification_audit_date
    certification_identification
    certification_standard
    certification_statement
    certification_status
    certification_type
    certification_uri
    certification_value
    primary_attachment {
      id
      filename_download
    }
    account {
      id
      account_name
    }
    user_created {
      id
      first_name
      last_name
    }
    date_created
    user_updated {
      id
      first_name
      last_name
    }
    date_updated
  }
}

Returns

Returns a certification object if a valid primary key was provided.

---

Create a Certification

Create a new certification.

REST

POST /items/certification

{
  "certification_agency": "USDA",
  "certification_agency_url": "https://www.usda.gov/",
  "certification_standard": "USDA Organic",
  "certification_type": "Organic",
  "certification_status": "ACTIVE",
  "certification_identification": "2780003077",
  "certification_start_date": "2024-05-02",
  "certification_end_date": "2025-05-01"
}

GraphQL

mutation {
  create_certification_item(data: {
    certification_agency: "USDA"
    certification_agency_url: "https://www.usda.gov/"
    certification_standard: "USDA Organic"
    certification_type: "Organic"
    certification_status: "ACTIVE"
    certification_identification: "2780003077"
    certification_start_date: "2024-05-02"
    certification_end_date: "2025-05-01"
  }) {
    id
    certification_agency
    certification_standard
    certification_status
  }
}

Query Parameters

Supports all global query parameters.

Request Body

A partial certification object.

Returns

Returns the certification object for the created certification.

---

Update a Certification

Update an existing certification.

REST

PATCH /items/certification/:id

{
  "certification_status": "EXPIRED",
  "certification_end_date": "2025-05-01"
}

GraphQL

mutation {
  update_certification_item(id: "certification_id", data: {
    certification_status: "EXPIRED"
    certification_end_date: "2025-05-01"
  }) {
    id
    certification_status
    certification_end_date
  }
}

Query Parameters

Supports all global query parameters.

Request Body

A partial certification object.

Returns

Returns the certification object for the updated certification.

---

Delete a Certification

Delete an existing certification.

REST

DELETE /items/certification/:id

GraphQL

mutation {
  delete_certification_item(id: "certification_id") {
    id
  }
}

Returns

Empty body.