Endpoints

Browse endpoints available

Get all accounts

get

https://api.plock.iohttps://test-api.plock.io

/api/c1/accounts

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Header parameters

Acceptstring · enumRequired

The client must specify an Accept header.

Possible values:

Responses

200

OK

application/vnd.api+json

401

Unauthorized

application/vnd.api+json

get

/api/c1/accounts

HTTPcURLJavaScriptPython

GET /api/c1/accounts HTTP/1.1
Host: api.plock.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/vnd.api+json

{
  "meta": {
    "page": {
      "currentPage": 1,
      "from": 1,
      "lastPage": 1,
      "perPage": 1,
      "to": 1,
      "total": 1
    }
  },
  "jsonapi": {
    "version": "1.0"
  },
  "links": {
    "first": "text",
    "last": "text",
    "next": "text"
  },
  "data": [
    {
      "type": "accounts",
      "id": "2002",
      "attributes": {
        "primaryKey": "a443322",
        "name": "Some Company AB",
        "orgNumber": "554433-3344",
        "crmId": "hs321",
        "erpId": "fn432",
        "country": "Sweden",
        "parentAccountId": 1,
        "createdAt": "2026-01-12T23:22:43.763Z",
        "updatedAt": "2026-01-12T23:22:43.763Z",
        "isGroup": true,
        "belongsToGroup": true,
        "isArchived": true,
        "isActive": true,
        "isPending": true,
        "stats": {
          "mrr_committed_fees": [
            100.5,
            200.3,
            300.2
          ],
          "mrr_usage_fees": [
            0,
            0,
            0
          ],
          "mrr_one_time_fees": [
            0,
            0,
            200
          ],
          "billings_committed_fees": [
            0,
            0,
            601
          ],
          "billings_usage_fees": [
            0,
            0,
            0
          ],
          "billings_one_time_fees": [
            0,
            0,
            200
          ]
        }
      },
      "relationships": {
        "subscriptions": "text",
        "invoices": "text"
      },
      "links": {
        "self": "text"
      }
    }
  ]
}

Get specific account

get

https://api.plock.iohttps://test-api.plock.io

/api/c1/accounts/{accountId}

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdintegerRequired

Plock account ID

Query parameters

Header parameters

Acceptstring · enumRequired

The client must specify an Accept header.

Possible values:

Responses

200

OK

application/vnd.api+json

401

Unauthorized

application/vnd.api+json

404

Not found

application/vnd.api+json

get

/api/c1/accounts/{accountId}

HTTPcURLJavaScriptPython

GET /api/c1/accounts/{accountId} HTTP/1.1
Host: api.plock.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/vnd.api+json

{
  "jsonapi": {
    "version": "1.0"
  },
  "links": {
    "self": "text"
  },
  "data": {
    "type": "accounts",
    "id": "2002",
    "attributes": {
      "primaryKey": "a443322",
      "name": "Some Company AB",
      "orgNumber": "554433-3344",
      "crmId": "hs321",
      "erpId": "fn432",
      "country": "Sweden",
      "parentAccountId": 1,
      "createdAt": "2026-01-12T23:22:43.763Z",
      "updatedAt": "2026-01-12T23:22:43.763Z",
      "isGroup": true,
      "belongsToGroup": true,
      "isArchived": true,
      "isActive": true,
      "isPending": true,
      "stats": {
        "mrr_committed_fees": [
          100.5,
          200.3,
          300.2
        ],
        "mrr_usage_fees": [
          0,
          0,
          0
        ],
        "mrr_one_time_fees": [
          0,
          0,
          200
        ],
        "billings_committed_fees": [
          0,
          0,
          601
        ],
        "billings_usage_fees": [
          0,
          0,
          0
        ],
        "billings_one_time_fees": [
          0,
          0,
          200
        ]
      }
    },
    "relationships": {
      "subscriptions": "text",
      "invoices": "text"
    },
    "links": {
      "self": "text"
    }
  }
}

Get all subscriptions

get

https://api.plock.iohttps://test-api.plock.io

/api/c1/subscriptions

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Header parameters

Acceptstring · enumRequired

The client must specify an Accept header.

Possible values:

Responses

200

OK

application/vnd.api+json

401

Unauthorized

application/vnd.api+json

get

/api/c1/subscriptions

HTTPcURLJavaScriptPython

GET /api/c1/subscriptions HTTP/1.1
Host: api.plock.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/vnd.api+json

{
  "meta": {
    "page": {
      "currentPage": 1,
      "from": 1,
      "lastPage": 1,
      "perPage": 1,
      "to": 1,
      "total": 1
    }
  },
  "jsonapi": {
    "version": "1.0"
  },
  "links": {
    "first": "text",
    "last": "text",
    "next": "text"
  },
  "data": [
    {
      "type": "subscriptions",
      "id": "2002",
      "attributes": {
        "accountId": "2002",
        "crmDealId": "40048111",
        "name": "My annual subscription",
        "billingInterval": "month",
        "billingIntervalName": "Monthly in arrears",
        "billingPractice": "in_arrears",
        "state": "Ended",
        "billingIntervalCount": 12,
        "isActive": true,
        "billingCycleAnchor": "2026-01-12T23:22:43.763Z",
        "renewalDate": "2025-06-30",
        "renewalTerm": 12,
        "cancelEndDate": "2025-05-30",
        "cancelPeriod": 3,
        "rebateEndDate": "2024-07-01",
        "rebateAmount": 2000,
        "rebateType": "percent",
        "currency": "SEK",
        "minimumCommitment": 2000,
        "currentBillingPeriod": "2024-03-01 - 2024-03-31",
        "autoSendToAccounting": true,
        "endDate": "2024-07-01",
        "createdAt": "2026-01-12T23:22:43.763Z",
        "updatedAt": "2026-01-12T23:22:43.763Z",
        "nextIndexationDate": "2026-01-01",
        "indexationPercentage": "4.5",
        "stats": {
          "mrr_committed_fees": [
            100.5,
            200.3,
            300.2
          ],
          "mrr_usage_fees": [
            0,
            0,
            0
          ],
          "mrr_one_time_fees": [
            0,
            0,
            200
          ],
          "billings_committed_fees": [
            0,
            0,
            601
          ],
          "billings_usage_fees": [
            0,
            0,
            0
          ],
          "billings_one_time_fees": [
            0,
            0,
            200
          ]
        }
      },
      "relationships": {
        "accounts": "text",
        "invoices": "text",
        "subscription-items": "text"
      },
      "links": {
        "self": "text"
      }
    }
  ]
}

Get specific subscription

get

https://api.plock.iohttps://test-api.plock.io

/api/c1/subscriptions/{subscriptionId}

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

subscriptionIdintegerRequired

Plock subscription ID

Query parameters

Header parameters

Acceptstring · enumRequired

The client must specify an Accept header.

Possible values:

Responses

200

OK

application/vnd.api+json

401

Unauthorized

application/vnd.api+json

404

Not found

application/vnd.api+json

get

/api/c1/subscriptions/{subscriptionId}

HTTPcURLJavaScriptPython

GET /api/c1/subscriptions/{subscriptionId} HTTP/1.1
Host: api.plock.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/vnd.api+json

{
  "jsonapi": {
    "version": "1.0"
  },
  "links": {
    "self": "text"
  },
  "data": {
    "type": "subscriptions",
    "id": "2002",
    "attributes": {
      "accountId": "2002",
      "crmDealId": "40048111",
      "name": "My annual subscription",
      "billingInterval": "month",
      "billingIntervalName": "Monthly in arrears",
      "billingPractice": "in_arrears",
      "state": "Ended",
      "billingIntervalCount": 12,
      "isActive": true,
      "billingCycleAnchor": "2026-01-12T23:22:43.763Z",
      "renewalDate": "2025-06-30",
      "renewalTerm": 12,
      "cancelEndDate": "2025-05-30",
      "cancelPeriod": 3,
      "rebateEndDate": "2024-07-01",
      "rebateAmount": 2000,
      "rebateType": "percent",
      "currency": "SEK",
      "minimumCommitment": 2000,
      "currentBillingPeriod": "2024-03-01 - 2024-03-31",
      "autoSendToAccounting": true,
      "endDate": "2024-07-01",
      "createdAt": "2026-01-12T23:22:43.763Z",
      "updatedAt": "2026-01-12T23:22:43.763Z",
      "nextIndexationDate": "2026-01-01",
      "indexationPercentage": "4.5",
      "stats": {
        "mrr_committed_fees": [
          100.5,
          200.3,
          300.2
        ],
        "mrr_usage_fees": [
          0,
          0,
          0
        ],
        "mrr_one_time_fees": [
          0,
          0,
          200
        ],
        "billings_committed_fees": [
          0,
          0,
          601
        ],
        "billings_usage_fees": [
          0,
          0,
          0
        ],
        "billings_one_time_fees": [
          0,
          0,
          200
        ]
      }
    },
    "relationships": {
      "accounts": "text",
      "invoices": "text",
      "subscription-items": "text"
    },
    "links": {
      "self": "text"
    }
  }
}

Get all invoices

get

https://api.plock.iohttps://test-api.plock.io

/api/c1/invoices

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Header parameters

Acceptstring · enumRequired

The client must specify an Accept header.

Possible values:

Responses

200

OK

application/vnd.api+json

401

Unauthorized

application/vnd.api+json

get

/api/c1/invoices

HTTPcURLJavaScriptPython

GET /api/c1/invoices HTTP/1.1
Host: api.plock.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/vnd.api+json

{
  "meta": {
    "page": {
      "currentPage": 1,
      "from": 1,
      "lastPage": 1,
      "perPage": 1,
      "to": 1,
      "total": 1
    }
  },
  "jsonapi": {
    "version": "1.0"
  },
  "links": {
    "first": "text",
    "last": "text",
    "next": "text"
  },
  "data": [
    {
      "type": "invoices",
      "id": "2002",
      "attributes": {
        "amount": "1000.00",
        "accountId": "5001",
        "erpId": "fn123",
        "subscriptionId": "4342",
        "currency": "EUR",
        "invoiceType": "In arrears",
        "periodStart": "2026-01-12",
        "periodEnd": "2026-01-12",
        "createdAt": "2026-01-12T23:22:43.763Z",
        "updatedAt": "2026-01-12T23:22:43.763Z",
        "dueAt": "2026-01-12T23:22:43.763Z",
        "paymentStatus": "Paid",
        "parentInvoiceId": 1001,
        "isParent": false
      },
      "relationships": {
        "subscriptions": "text",
        "accounts": "text"
      },
      "links": {
        "self": "text"
      }
    }
  ]
}

Get specific invoice

get

https://api.plock.iohttps://test-api.plock.io

/api/c1/invoices/{invoiceId}

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

invoiceIdintegerRequired

Plock invoice ID

Query parameters

Header parameters

Acceptstring · enumRequired

The client must specify an Accept header.

Possible values:

Responses

200

OK

application/vnd.api+json

401

Unauthorized

application/vnd.api+json

404

Not found

application/vnd.api+json

get

/api/c1/invoices/{invoiceId}

HTTPcURLJavaScriptPython

GET /api/c1/invoices/{invoiceId} HTTP/1.1
Host: api.plock.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/vnd.api+json

{
  "jsonapi": {
    "version": "1.0"
  },
  "links": {
    "self": "text"
  },
  "data": {
    "type": "invoices",
    "id": "2002",
    "attributes": {
      "amount": "1000.00",
      "accountId": "5001",
      "erpId": "fn123",
      "subscriptionId": "4342",
      "currency": "EUR",
      "invoiceType": "In arrears",
      "periodStart": "2026-01-12",
      "periodEnd": "2026-01-12",
      "createdAt": "2026-01-12T23:22:43.763Z",
      "updatedAt": "2026-01-12T23:22:43.763Z",
      "dueAt": "2026-01-12T23:22:43.763Z",
      "paymentStatus": "Paid",
      "parentInvoiceId": 1001,
      "isParent": false
    },
    "relationships": {
      "subscriptions": "text",
      "accounts": "text"
    },
    "links": {
      "self": "text"
    }
  }
}

Get all product usage

get

https://api.plock.iohttps://test-api.plock.io

/api/c1/product-usages

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Header parameters

Acceptstring · enumRequired

The client must specify an Accept header.

Possible values:

Responses

200

OK

application/vnd.api+json

401

Unauthorized

application/vnd.api+json

get

/api/c1/product-usages

HTTPcURLJavaScriptPython

GET /api/c1/product-usages HTTP/1.1
Host: api.plock.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/vnd.api+json

{
  "meta": {
    "page": {
      "currentPage": 1,
      "from": 1,
      "lastPage": 1,
      "perPage": 1,
      "to": 1,
      "total": 1
    }
  },
  "jsonapi": {
    "version": "1.0"
  },
  "links": {
    "first": "text",
    "last": "text",
    "next": "text"
  },
  "data": [
    {
      "type": "product-usage",
      "id": "2002",
      "attributes": {
        "accountId": 13321,
        "crmId": "a341324",
        "productId": 41231,
        "value": 1.0576,
        "timestamp": "2025-05-30T00:00:00.000000Z"
      },
      "relationships": {},
      "links": {
        "self": "text"
      }
    }
  ]
}

Add product usage

post

https://api.plock.iohttps://test-api.plock.io

/api/c1/product-usages

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

Acceptstring · enumRequired

The client must specify an Accept header.

Possible values:

Content-Typestring · enumRequired

The client must specify a Content-Type header.

Possible values:

Body

application/json

tsintegerOptional

UNIX timestamp of value

Example: 1756582856

valuenumber · floatOptional

Value recorded at ts

Example: 10.5

crm_idstringOptional

CRM ID of the account

Example: xx123

product_idintegerOptional

Product ID for the product

Example: 332

Responses

200

OK

application/json

401

Unauthorized

application/json

404

Not found

application/json

422

Unprocessable content

application/json

post

/api/c1/product-usages

HTTPcURLJavaScriptPython

POST /api/c1/product-usages HTTP/1.1
Host: api.plock.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: application/json
Content-Type: application/json
Content-Length: 64

{
  "ts": 1756582856,
  "value": 10.5,
  "crm_id": "xx123",
  "product_id": 332
}

{
  "success": true
}