Get offers

GET

offers

curl -X GET \
 /offers \
 --header "Authorization: Bearer <token>"

{
  "data": [
    {
      "id": "<string>",
      "subscription": {
        "id": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
        "externalId": "<string>",
        "number": "S-00000001",
        "name": "Fitness M",
        "billingGroup": {},
        "periods": [
          {
            "id": "<string>",
            "contractPeriodCount": 123,
            "contractPeriod": {},
            "cancellationPeriod": {}
          }
        ],
        "status": "<any>",
        "activatedAt": "2021-01-01T00:00:00+00:00",
        "poNumber": "PO-00000001",
        "contractDetails": {
          "contractStart": "2023-11-07T05:31:56Z",
          "contractEnd": "2023-11-07T05:31:56Z"
        },
        "trialEndsOn": "2021-01-01T00:00:00+00:00",
        "customFields": {
          "field1": "value1",
          "field2": "value2"
        },
        "createdAt": "2021-01-01T00:00:00+00:00",
        "updatedAt": "2021-01-01T00:00:00+00:00",
        "nextBillingDate": "2023-11-07T05:31:56Z",
        "lastBillingAt": "2023-11-07T05:31:56Z",
        "partner": {
          "id": "ad8f7e7d-3b3b-4b3b-8b3b-3b3b3b3b3b3b",
          "name": "John Doe",
          "number": "123456",
          "email": "partner@example.com"
        }
      },
      "customer": {
        "id": "00000000-0000-0000-0000-000000000000",
        "customerNumber": "CUSTOMER-000",
        "timeZone": "Europe/Berlin",
        "firstName": "John",
        "lastName": "Doe",
        "currencyCode": "EUR",
        "companyName": "Acme Inc.",
        "datevId": "123456789",
        "status": "STATUS_ACTIVE"
      },
      "number": "<string>",
      "name": "<string>",
      "status": "open",
      "description": "<string>",
      "sections": [
        "<string>"
      ],
      "locale": "<string>",
      "recipients": [
        {
          "id": "<string>",
          "email": "<string>",
          "firstName": "<string>",
          "lastName": "<string>",
          "role": "read",
          "createdAt": "2023-11-07T05:31:56Z",
          "signingStatus": "not_started",
          "signingLog": [
            "<string>"
          ],
          "signedDocument": "https://example.com/",
          "link": "https://example.com/offers/1/recipient-1"
        }
      ],
      "auditLogDocument": "https://example.com/",
      "signedDocument": "https://example.com/",
      "signedAt": "2023-11-07T05:31:56Z",
      "autoActivateSubscription": true,
      "crmDealId": "<string>",
      "createdAt": "2021-01-01T00:00:00+00:00",
      "updatedAt": "2021-01-01T00:00:00+00:00",
      "contactPerson": {
        "id": "<string>",
        "firstName": "<string>",
        "lastName": "<string>",
        "email": "<string>",
        "avatar": "<string>"
      }
    }
  ],
  "meta": {
    "pagination": {
      "totalItems": 123,
      "itemsPerPage": 123,
      "currentPage": 123,
      "lastPage": 123,
      "pageTotalItems": 123
    }
  }
}

Authorizations

Authorization

string

header

required

Value for the Authorization header parameter.

Query Parameters

page

integer

default:1

The collection page number

limit

integer

default:30

The number of items per page

Required range: 0 <= x <= 100

Response

200

application/json

Offer collection

data

object[]

data.id

string

data.subscription

object | null

data.subscription.id

string

Example:

"ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b"

data.subscription.externalId

string | null

data.subscription.number

string

The number of the subscription.

Example:

"S-00000001"

data.subscription.name

string | null

The name of the subscription. Defaults to the name of the plan. This will be used in the invoice for the grouping headers.

Example:

"Fitness M"

data.subscription.billingGroup

object | null

The billing group defines the billing cycle of the subscription.

data.subscription.periods

object[]

data.subscription.status

any

The status of the subscription.

Possible values:

draft: The subscription is in draft mode and not active yet.
active: The subscription is active and will be billed.
paused: The subscription is paused and will not be billed.
cancelled: The subscription is cancelled and will not be billed anymore.
terminated: The subscription is terminated and will not be billed anymore.
offer: The subscription is an offer and waiting for acceptance.

data.subscription.activatedAt

string | null

The date the subscription was activated.

Example:

"2021-01-01T00:00:00+00:00"

data.subscription.poNumber

string | null

The po number of the subscription.

Example:

"PO-00000001"

data.subscription.contractDetails

object

The contract details of the subscription.

data.subscription.trialEndsOn

string | null

The date the trial period ends.

Example:

"2021-01-01T00:00:00+00:00"

data.subscription.customFields

object | null

Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide

Example:

{ "field1": "value1", "field2": "value2" }

data.subscription.createdAt

string

The date and time when the resource was created.

Example:

"2021-01-01T00:00:00+00:00"

data.subscription.updatedAt

string

The date and time when the resource was last updated.

Example:

"2021-01-01T00:00:00+00:00"

data.subscription.nextBillingDate

string | null

The next billing date of the subscription.

data.subscription.lastBillingAt

string | null

The last billing date of the subscription.

data.subscription.partner

object | null

The partner of the customer.

data.customer

object | null

data.number

string

data.name

string | null

data.status

enum<string>

Available options:

open,

signed,

signing,

archived

data.description

string | null

data.sections

string[]

data.locale

string

data.recipients

object[]

data.auditLogDocument

string | null

Example:

"https://example.com/"

data.signedDocument

string | null

Example:

"https://example.com/"

data.signedAt

string | null

data.autoActivateSubscription

boolean

default:true

Example:

true

data.crmDealId

string | null

data.createdAt

string

The date and time when the resource was created.

Example:

"2021-01-01T00:00:00+00:00"

data.updatedAt

string

The date and time when the resource was last updated.

Example:

"2021-01-01T00:00:00+00:00"

data.contactPerson

object | null

The contact person of the offer

meta

object

Get a collection of billing groups Get an offer

curl -X GET \
 /offers \
 --header "Authorization: Bearer <token>"

{
  "data": [
    {
      "id": "<string>",
      "subscription": {
        "id": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
        "externalId": "<string>",
        "number": "S-00000001",
        "name": "Fitness M",
        "billingGroup": {},
        "periods": [
          {
            "id": "<string>",
            "contractPeriodCount": 123,
            "contractPeriod": {},
            "cancellationPeriod": {}
          }
        ],
        "status": "<any>",
        "activatedAt": "2021-01-01T00:00:00+00:00",
        "poNumber": "PO-00000001",
        "contractDetails": {
          "contractStart": "2023-11-07T05:31:56Z",
          "contractEnd": "2023-11-07T05:31:56Z"
        },
        "trialEndsOn": "2021-01-01T00:00:00+00:00",
        "customFields": {
          "field1": "value1",
          "field2": "value2"
        },
        "createdAt": "2021-01-01T00:00:00+00:00",
        "updatedAt": "2021-01-01T00:00:00+00:00",
        "nextBillingDate": "2023-11-07T05:31:56Z",
        "lastBillingAt": "2023-11-07T05:31:56Z",
        "partner": {
          "id": "ad8f7e7d-3b3b-4b3b-8b3b-3b3b3b3b3b3b",
          "name": "John Doe",
          "number": "123456",
          "email": "partner@example.com"
        }
      },
      "customer": {
        "id": "00000000-0000-0000-0000-000000000000",
        "customerNumber": "CUSTOMER-000",
        "timeZone": "Europe/Berlin",
        "firstName": "John",
        "lastName": "Doe",
        "currencyCode": "EUR",
        "companyName": "Acme Inc.",
        "datevId": "123456789",
        "status": "STATUS_ACTIVE"
      },
      "number": "<string>",
      "name": "<string>",
      "status": "open",
      "description": "<string>",
      "sections": [
        "<string>"
      ],
      "locale": "<string>",
      "recipients": [
        {
          "id": "<string>",
          "email": "<string>",
          "firstName": "<string>",
          "lastName": "<string>",
          "role": "read",
          "createdAt": "2023-11-07T05:31:56Z",
          "signingStatus": "not_started",
          "signingLog": [
            "<string>"
          ],
          "signedDocument": "https://example.com/",
          "link": "https://example.com/offers/1/recipient-1"
        }
      ],
      "auditLogDocument": "https://example.com/",
      "signedDocument": "https://example.com/",
      "signedAt": "2023-11-07T05:31:56Z",
      "autoActivateSubscription": true,
      "crmDealId": "<string>",
      "createdAt": "2021-01-01T00:00:00+00:00",
      "updatedAt": "2021-01-01T00:00:00+00:00",
      "contactPerson": {
        "id": "<string>",
        "firstName": "<string>",
        "lastName": "<string>",
        "email": "<string>",
        "avatar": "<string>"
      }
    }
  ],
  "meta": {
    "pagination": {
      "totalItems": 123,
      "itemsPerPage": 123,
      "currentPage": 123,
      "lastPage": 123,
      "pageTotalItems": 123
    }
  }
}

API documentation

User

Tenant

Feature

Entitlement

User & permissions

Settings

Payment

Analytics

Customer

Billing

Dunning

Subscription

Offers

Catalogue

Checkout

Accounting

Taxes

Authorizations

Query Parameters

Response