Invoice series

API version
Select a version to change the base URI
in syntax and code examples. Learn about versions
:

Represents a list of invoice series.

URI
/api/v10/invoices/series

List invoice series

List all invoice series configured in DreamApply.

Invoice series are used to generate new numbers for invoices under a specific series. For example, an invoice for application fees and tuition fees may be issued with different series to maintain different numbering schemes.

Format markers

Marker	Description
`%inc%`	The finance document number (continuous)
`%incYearly%`	The finance document number (re-started yearly)
`%incMonthly%`	The finance document number (re-started monthly)
`%incDaily%`	The finance document number (re-started daily)
`%yearLong%`	The long year number, for example, `2023`
`%yearShort%`	The short year number, for example, `23`
`%month%`	The zero-padded month number, for example, `02`
`%day%`	The zero-padded day number, for example, `31` or `03`

Syntax
GET /api/v10/invoices/series
Host: apply.example.edu
Authorization: DREAM apikey="..."

Example request

Request
curl
curl \
  -X GET \
  -H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
  "https://apply.example.edu/api/v10/invoices/series"

Response headers

Header	Value	Description
`Content-Type`	`application/json`	The media type of the resource
`Content-Length`	`1234`	The size of the response body in bytes
`X-Count`	`15`	The number of returned series

Response codes

Response code	Description
`200 OK`	The list of series was successfully returned

Example response

Response
{
  "1": {
    "id": 1,
    "name": "Tuition fee",
    "format": "TF-%incYearly%%day%%month%%yearShort%",
    "last": {
      "when": "2025-10-21T07:02:40+00:00",
      "number": "TF-9211025"
    }
  },
  "2": {
    "id": 2,
    "name": "Application fee",
    "format": "AF-%incYearly%%day%%month%%yearShort%",
    "last": {
      "when": "2025-12-16T09:54:07+00:00",
      "number": "AF-105161225"
    }
  },
  "100": {
    "id": 100,
    "name": "Default invoice series",
    "format": "%inc%",
    "last": {
      "when": "2025-04-29T10:28:47+00:00",
      "number": "57"
    }
  },
  "200": {
    "id": 200,
    "name": "Shopping invoice series",
    "format": "SH-%yearShort%%inc%",
    "last": {
      "when": "2025-05-08T12:22:51+00:00",
      "number": "SH-25386"
    }
  }
}