POST
/
companies
/
{company_id}
/
credits
curl --request POST \
  --url https://api.maplebilling.com/api/v1/companies/{company_id}/credits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": {
    "currency": "<string>",
    "value_in_cents": 123
  },
  "apply_to_open_invoices": {
    "enable": true,
    "invoice_uuids": [
      "<string>"
    ]
  },
  "customer_id": "<string>",
  "expiration_date": "2023-11-07T05:31:56Z",
  "item_id": "<string>",
  "name": "<string>",
  "state": "ACTIVE",
  "subscription_id": "<string>",
  "type": "<string>",
  "units": 123
}'
{
  "amount": {
    "currency": "<string>",
    "value_in_cents": 123
  },
  "coupon_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "customer_id": "<string>",
  "expiration_date": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "import_created_at_ref": "2023-11-07T05:31:56Z",
  "import_ref": "<string>",
  "imported_from": "<string>",
  "issued_amount": {
    "currency": "<string>",
    "value_in_cents": 123
  },
  "issued_units": 123,
  "item": {
    "company_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "description": "<string>",
    "display_type": "<string>",
    "editable": true,
    "external_name": "<string>",
    "id": "<string>",
    "name": "<string>",
    "standard": true,
    "type": "<string>",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "item_id": "<string>",
  "metric_record_id": "<string>",
  "name": "<string>",
  "one_time_billable_id": "<string>",
  "proration_date": "2023-11-07T05:31:56Z",
  "state": "<string>",
  "subscription_id": "<string>",
  "type": "<string>",
  "units": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Idempotency-Key
string

The idempotency key that will be used to ensure the request is only performed once

Path Parameters

​
company_id
string
required

Company ID. It should have a prefix 'cmp_'.

Body

application/json

Response

201 - application/json

Created

The response is of type object.