Introduction

​

Conventions

• Naming: every JSON field is snake_case.
• Money: integer values in the smallest currency unit (e.g. cents). No human-formatted strings. Decimals vary by currency — see Amounts & Currencies.
• Phone: international, digits only, no leading +.
• Order number: the raw counter integer as a string. No prefix/suffix.
• Errors: structured { error: { type, code, message, param?, request_id } }.
• Lists: cursor-paginated { object: "list", data, has_more, next_cursor }.

​

Authentication

GET https://take.app/api/v2/me
Authorization: Bearer YOUR_API_TOKEN

• 401 authentication_error — missing or invalid token.
• 403 permission_error — reserved for future scope checks.

​

Idempotency

POST https://take.app/api/v2/orders
Authorization: Bearer YOUR_API_TOKEN
Idempotency-Key: 0d3c9d04-2f2b-4e7c-9c4c-b8c0f7e0a1ab

​

Pagination

{
  "object": "list",
  "data": [ /* ... */ ],
  "has_more": true,
  "next_cursor": "eyJjcmVhdGVkQXQiOi..."
}

​

Errors

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_parameter",
    "message": "Customer phone is required",
    "param": "customer.phone",
    "request_id": "req_xxx"
  }
}

​

Rate limits

​

Resources

• Store — /api/v2/me
• Products — /api/v2/products (see Working with products)
• Categories — /api/v2/categories
• Customers — /api/v2/customers
• Orders — /api/v2/orders
• Inventory items — /api/v2/inventory_items
• Messages — /api/v2/messages
• Message templates — /api/v2/message_templates