v1

latestSwagger 2.0MIT2026-07-1310778293.3 KB
Guids

Retrieve ID4n information

Retrieving basic information about an ID like the type and the creation time.

get/api/v1/id4ns/{id4n}

Path parameters

id4nstring required

The ID to resolve to

Query parameters

organizationIdstring

The organization namespace to resolve.

Response

OK

createdTimestampinteger

The UTC unix timestamp of when this ID has been created

holderOrganizationIdstring

Organization namespace of the holder of the ID

id4nstring

The ID

labelstring
ownerOrganizationIdstring

Organization namespace of the ID owner

propertiesobject

The properties of the organization

type'GUID' | 'ROUTING_COLLECTION' | 'LOGISTIC_COLLECTION' | 'LABELLED_COLLECTION'

The type of ID

Example response

{
  "createdTimestamp": 1517232722,
  "holderOrganizationId": "de.example",
  "id4n": "3THvgrWxqgTFC4",
  "ownerOrganizationId": "org.acme"
}