ConnectCloud Developers

List the number ranges (tenant:masterdata:read)

GET /api/masterdata/sequences

Module: Master data · operationId: listSequences · Tag: Settings · Auth: access token (Authorization: Bearer <accessToken>)

Responses

  • 200 Number ranges (application/json)
  • 401 Missing, invalid or expired token (empty body)
  • 403 The token lacks the permission or carries no tenant (application/json)

Fields of the 200 answer:

  • items (array of Sequence, required)
    • currentValue (integer (int64), required): Last assigned value
    • highestIssued (integer (int64), required): Highest number with this prefix already in use (0 when none); the counter cannot be set below it
    • minDigits (integer, required): Minimum number of digits (zero-padded)
    • nextNumber (string, required): The next number that would be assigned
    • prefix (string, required): Prefix of the numbers
    • sequenceType (string, required): ADDRESS, PRODUCT, MANDATE or a named address range ADDRESS:NAME
    • updatedAt (string (date-time), required): Time of the last change
    • label (string): Name of a named range

Example 200 answer:

{
  "items": [
    {
      "currentValue": 10031,
      "highestIssued": 10031,
      "label": "Adressen",
      "minDigits": 5,
      "nextNumber": "10032",
      "prefix": "",
      "sequenceType": "ADDRESS",
      "updatedAt": "2026-11-04T09:15:00Z"
    },
    {
      "currentValue": 70011,
      "highestIssued": 70011,
      "label": "Lieferantennummern",
      "minDigits": 5,
      "nextNumber": "70012",
      "prefix": "",
      "sequenceType": "ADDRESS:LIEFERANT",
      "updatedAt": "2026-09-02T14:30:00Z"
    }
  ]
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/masterdata/sequences' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI