Skip to main content

Documentation Index

Fetch the complete documentation index at: https://piriod-d406ac55.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Piriod is a billing, payments, procurement and collections platform. The API exposes the same building blocks our dashboard uses, so you can issue invoices, charge cards, manage subscriptions and reconcile payments programmatically.

Base URL

https://api.piriod.com

Required headers on every request

HeaderRequiredDescription
AuthorizationYesToken <api_token>. See Authentication.
x-simple-workspaceYesThe workspace (account) identifier you are operating on.
x-piriod-test-modeNotrue to use test-mode data. Defaults to false.

Hello world

curl https://api.piriod.com/customers/ \
  -H "Authorization: Token sk_live_xxxxx" \
  -H "x-simple-workspace: acc_01H8XYZ123ABC"
The response is a paginated list of customers; see Pagination and filtering.

What’s next