Numbering

Invoice and estimate numbers are assigned automatically from your company's numbering settings. You can view the next numbers that will be used and update settings (prefix, zero-padding, and optional one-time overrides) via the Developer API.

Settings are configured in the web app under **Settings → Invoice Numbering** and **Settings → Estimate Numbering**. The same settings are readable and writable via the API below.

View as Markdown

Endpoints

GET/api/v1/numbering

PUT/api/v1/numbering

Get next numbers and settings

Returns the current invoice and estimate numbering settings and the **next** numbers that will be assigned (based on prefix, padding, and any one-time override).

GET/api/v1/numbering

curl -G \
  https://customtradescrm.com/api/v1/numbering \
  -H "Authorization: Bearer ctc_live_..."

Response

{
  "success": true,
  "data": {
    "invoice": {
      "prefix": "INV-",
      "padding": 4,
      "next_number": 88,
      "next_number_formatted": "INV-0088",
      "has_override": false
    },
    "estimate": {
      "prefix": "EST-",
      "padding": 4,
      "next_number": 1522,
      "next_number_formatted": "EST-1522",
      "has_override": false
    }
  }
}

Update numbering settings

Update invoice and/or estimate numbering settings. All body fields are optional; only provided fields are updated. **Request Body:**

Error codes

HTTP status code	Description
200	Success
400	Validation error (e.g. invalid prefix or padding)
401	Unauthorized (invalid API key)
403	Forbidden (add-on required or usage limit exceeded)
500	Server error

PUT/api/v1/numbering

curl -G \

Response

{
  "success": true,
  "data": {
    "message": "Numbering settings updated successfully"
  }
}