Skip to content

Designed
Get food specification versions

Request

Returns all versions of the same logical specification. Given any version's ID, the server resolves the version chain and returns all sibling versions sorted by version number descending.

Security
oauth2(Required scopes: t1_api)
Path
specificationIdstring, (uuid)required

The unique identifier of the specification

curl -i -X GET \
  'https://apis.traceone.com/spec/v2/food/specifications/{specificationId}/versions' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Returns all versions of the specification

Bodyapplication/json
Array [
specificationIdstring, (uuid)
namestring or null
statusstring(SpecificationStatus)read-only

Lifecycle status of a specification version. Draft: not yet in progress. InProgress: being filled. ValidatedBySupplier / ValidatedByRetailer: validated by that party. LockedForSupplierSignature / LockedForRetailerSignature: locked while that party signs. SignedBySupplier / SignedByRetailer: signed by that party. InRevisionBySupplier / InRevisionByRetailer: reopened for revision by that party.

Enum:"Draft""InProgress""ValidatedBySupplier""ValidatedByRetailer""LockedForSupplierSignature""LockedForRetailerSignature""SignedBySupplier""SignedByRetailer""InRevisionBySupplier""InRevisionByRetailer"
versionobject(ObjectVersion)
ownerCompanyIdstring, (uuid)
supplierCompanyIdstring or null, (uuid)
creationDateUtcstring, (date-time)
]
Response
[
  {
    "specificationId": "df380d59-2906-4417-bec3-4ac4567b1960",
    "name": "string",
    "status": "Draft",
    "version": { … },
    "ownerCompanyId": "10e96248-c873-4e93-b748-bc36e39510eb",
    "supplierCompanyId": "60e634ac-9cf5-4a73-a6b6-1e5d15116468",
    "creationDateUtc": "2019-08-24T14:15:22Z"
  }
]