action id4i_get_collections {
  label: "Retrieve collections of an ID"
  description: "Retrieving all owned or holding collections the specified id4n is assigned to."
  provider: id4i
  method: GET
  path: "/api/v1/id4ns/{id4n}/collections"
  encoding: json
  input: {
    type: "object"
    properties: {
      id4n: {
        type: "string"
      }
      limit: {
        type: "integer"
        format: "int32"
      }
      offset: {
        type: "integer"
        format: "int32"
      }
      organizationId: {
        type: "string"
      }
    }
    required: ["id4n"]
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["elements", "limit", "offset"]
    properties: {
      elements: {
        type: "array"
        items: {
          type: "object"
          properties: {
            createdTimestamp: {
              type: "integer"
              format: "int64"
              description: "The UTC unix timestamp of when this collection has been created"
            }
            holderOrganizationId: {
              type: "string"
              description: "Organization namespace of the holder of the collection"
            }
            id4n: {
              type: "string"
              description: "The ID"
            }
            label: {
              type: "string"
            }
            ownerOrganizationId: {
              type: "string"
              description: "Organization namespace of the collection owner"
            }
            physicalState: {
              type: "string"
              description: "Physical attachment state of the collection"
              enum: ["UNATTACHED", "ATTACHED", "DETACHED"]
            }
            type: {
              type: "string"
              enum: ["ROUTING_COLLECTION", "LOGISTIC_COLLECTION", "LABELLED_COLLECTION"]
            }
          }
        }
      }
      limit: {
        type: "integer"
        format: "int32"
        description: "The number of returned elements"
      }
      offset: {
        type: "integer"
        format: "int32"
        description: "Starting with the n-th element"
      }
      total: {
        type: "integer"
        format: "int32"
        description: "The total number of elements"
      }
    }
  }
}