Split Billing

Retrieve a list of split billing settlements

GET

https://partner-api.monta.com

/api/v1/split-billing/settlements

Required scope: split-billing:read

Retrieve a list of split billing settlements › query Parameters

page

integer · int32

page number to retrieve (starts with 0)

Default: 0

perPage

integer · int32

number of items per page (between 1 and 100, default 10)

Default: 10

teamId

integer | null · int64

Filter settlements by the team they belong to.

Example: 42

status

string · enum

Filter settlements by status.

Enum values:

pending

completed

failed

Example: pending

createdAtFrom

string | null · date-time

Return settlements created on or after this timestamp (ISO 8601, e.g. 2026-01-01T00:00:00Z).

Example: 2026-01-01T00:00:00Z

createdAtTo

string | null · date-time

Return settlements created on or before this timestamp (ISO 8601, e.g. 2026-03-31T23:59:59Z).

Example: 2026-03-31T23:59:59Z

Retrieve a list of split billing settlements › Responses

List of split billing settlements that match the criteria

OffsetBasedResponse_55

SplitBillingSettlement[] · required

MontaPage.Meta · required

GET/api/v1/split-billing/settlements

curl https://partner-api.monta.com/api/v1/split-billing/settlements \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": 42,
      "teamId": 1024,
      "userId": 5050,
      "amount": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "total": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "status": "pending",
      "attempts": 1,
      "lastAttemptAt": "2026-05-10T08:30:00Z",
      "period": "April 2026",
      "firstItemAt": "2026-04-02T08:00:00Z",
      "lastItemAt": "2026-04-29T19:30:00Z",
      "sessionCount": 7,
      "createdAt": "2026-05-01T00:00:00Z"
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Retrieve a single split billing settlement

GET

https://partner-api.monta.com

/api/v1/split-billing/settlements/{settlementId}

Required scope: split-billing:read

Retrieve a single split billing settlement › path Parameters

settlementId

integer · int64 · required

Retrieve a single split billing settlement › Responses

Split billing settlement with provided id

SplitBillingSettlement

object · required

Amount due for this settlement.

object · required

Total amount including any fees.

status

string · enum · required

Settlement status.

Enum values:

pending

completed

failed

Example: pending

id

integer · int64

Id of this settlement.

Example: 42

teamId

integer · int64

Id of the team this settlement belongs to.

Example: 1024

userId

integer · int64

Id of the user that owns this settlement.

Example: 5050

attempts

integer · int32

Number of times the settlement has been attempted.

Example: 1

lastAttemptAt

string | null · date-time

When the settlement was last attempted.

Example: 2026-05-10T08:30:00Z

period

string | null

Server-rendered (English) label for the billing period the settlement covers, e.g. April 2026. Prefer firstItemAt/lastItemAt for locale-aware rendering.

Example: April 2026

firstItemAt

string | null · date-time

Timestamp of the earliest split-billing item in the settlement. Use together with lastItemAt to render a localised period. Null for historical settlements created before the field existed.

Example: 2026-04-02T08:00:00Z

lastItemAt

string | null · date-time

Timestamp of the latest split-billing item in the settlement. See firstItemAt.

Example: 2026-04-29T19:30:00Z

sessionCount

integer | null · int32

Number of split-billing charges included in this settlement.

Example: 7

createdAt

string | null · date-time

When this settlement was created.

Example: 2026-05-01T00:00:00Z

GET/api/v1/split-billing/settlements/{settlementId}

curl https://partner-api.monta.com/api/v1/split-billing/settlements/:settlementId \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": 42,
  "teamId": 1024,
  "userId": 5050,
  "amount": {
    "amount": 12312,
    "currency": {
      "id": 1,
      "master": true,
      "identifier": "DKK",
      "name": "Danish krone",
      "decimals": 2
    },
    "locale": "en"
  },
  "total": {
    "amount": 12312,
    "currency": {
      "id": 1,
      "master": true,
      "identifier": "DKK",
      "name": "Danish krone",
      "decimals": 2
    },
    "locale": "en"
  },
  "status": "pending",
  "attempts": 1,
  "lastAttemptAt": "2026-05-10T08:30:00Z",
  "period": "April 2026",
  "firstItemAt": "2026-04-02T08:00:00Z",
  "lastItemAt": "2026-04-29T19:30:00Z",
  "sessionCount": 7,
  "createdAt": "2026-05-01T00:00:00Z"
}

json

application/json

List items for a split billing settlement

GET

https://partner-api.monta.com

/api/v1/split-billing/settlements/{settlementId}/items

Required scope: split-billing:read

List items for a split billing settlement › path Parameters

settlementId

integer · int64 · required

List items for a split billing settlement › query Parameters

page

integer · int32

page number to retrieve (starts with 0)

Default: 0

perPage

integer · int32

number of items per page (between 1 and 100, default 10)

Default: 10

List items for a split billing settlement › Responses

List of split billing items for the given settlement

OffsetBasedResponse_54

SplitBillingItem[] · required

MontaPage.Meta · required

GET/api/v1/split-billing/settlements/{settlementId}/items

curl https://partner-api.monta.com/api/v1/split-billing/settlements/:settlementId/items \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": 1234,
      "processed": false,
      "chargeId": 98765,
      "settlementId": 42,
      "teamId": 100,
      "userId": 200,
      "kwhPriceCap": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "amount": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "createdAt": "2026-05-01T00:00:00Z"
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Sites Sponsored Charge Points