tenzro-xyz Orders API
The Orders API from tenzro-xyz — 3 operation(s) for orders.
The Orders API from tenzro-xyz — 3 operation(s) for orders.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/tenzro-xyz:tenzro-xyz-orders-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Tenzro Labs Platform Orders API
version: 1.0.0
description: Browse the curated catalogue; manage credits, billing, keys, plans and rentals; place and pay orders; run Datasets, Fieldwork, Voices and Forecasts. Chat, embeddings, images, speech and the model list keep the OpenAI-compatible /v1 paths.
servers:
- url: https://api.tenzro.xyz
security:
- apiKey: []
tags:
- name: Orders
paths:
/orders:
post:
tags:
- Orders
summary: Create an order
description: 'Creates an unpaid order for credits, a package, a rental, or a plan. Pay it with Pay an order, or send a person to pay_url. Nothing is charged until payment completes.
Needs a key with the `manage` permission.'
operationId: postOrders
x-tenzro-scope: manage
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- title: Credits
type: object
required:
- type
- amount_usd
properties:
type:
const: credits
amount_usd:
type: integer
minimum: 5
maximum: 5000
description: The fiat price to pay, in whole US dollars. The credits it buys are set by Tenzro Labs; until that price is set, credit orders are refused.
machine_id:
type: string
description: Pin the credit to one machine. Omit for credit usable anywhere.
gift:
type: boolean
description: Issue a redeemable ticket code instead of crediting this account.
- title: Package
type: object
required:
- type
- package_id
properties:
type:
const: package
package_id:
type: string
gift:
type: boolean
- title: Rental
type: object
required:
- type
- machine_id
- cpu_cores
- memory_gb
- hours
properties:
type:
const: rental
machine_id:
type: string
gpu:
type: integer
minimum: 0
cpu_cores:
type: integer
minimum: 1
memory_gb:
type: integer
minimum: 1
storage_gb:
type: integer
minimum: 0
hours:
type: integer
minimum: 1
- title: Subscription
type: object
required:
- type
- machine_id
- plan_id
properties:
type:
const: subscription
machine_id:
type: string
plan_id:
type: string
renew_subscription_id:
type: string
description: Renew an existing stablecoin plan for another 30 days.
example:
type: credits
amount_usd: 25
responses:
'200':
description: OK
content:
application/json:
example:
id: ord_4hYt2K9qLmN0pXr8
type: credits
title: Credit top-up · any machine
amount_usd: 25
currency: usd
status: pending
machine_id: null
payment:
method: null
pay_url: https://platform.tenzro.xyz/checkout/ord_4hYt2K9qLmN0pXr8
created_at: '2026-09-26T08:00:00.000Z'
paid_at: null
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
get:
tags:
- Orders
summary: List orders
description: Needs a key with the `read` permission.
operationId: getOrders
x-tenzro-scope: read
parameters:
- name: limit
in: query
required: false
description: 1–200, default 50.
schema:
type: integer
responses:
'200':
description: OK
content:
application/json:
example:
data:
- id: ord_4hYt2K9qLmN0pXr8
type: credits
title: Credit top-up · any machine
amount_usd: 25
currency: usd
status: pending
machine_id: null
payment:
method: null
pay_url: https://platform.tenzro.xyz/checkout/ord_4hYt2K9qLmN0pXr8
created_at: '2026-09-26T08:00:00.000Z'
paid_at: null
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/orders/{id}/pay:
post:
tags:
- Orders
summary: Pay an order
description: 'card returns a Stripe Checkout URL for a person to open. stablecoin returns a deposit address, token, chain and exact amount; the order is fulfilled when the deposit is received.
Needs a key with the `manage` permission.'
operationId: postOrdersByIdPay
x-tenzro-scope: manage
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- method
properties:
method:
enum:
- card
- stablecoin
chain:
type: string
description: Stablecoin only. See List payment methods.
token:
type: string
description: Stablecoin only, e.g. usdc.
example:
method: stablecoin
chain: base
token: usdc
responses:
'200':
description: OK
content:
application/json:
example:
id: ord_4hYt2K9qLmN0pXr8
type: credits
title: Credit top-up · any machine
amount_usd: 25
currency: usd
status: pending
machine_id: null
payment:
method: stablecoin
deposit:
chain: base
token: usdc
amount: '25.00'
address: 0x9f…c21
memo: null
pay_url: https://platform.tenzro.xyz/checkout/ord_4hYt2K9qLmN0pXr8
created_at: '2026-09-26T08:00:00.000Z'
paid_at: null
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/orders/{id}:
get:
tags:
- Orders
summary: Get an order
description: 'Current status. For a paid credit order, includes the ticket: its code, the credits it grants, and whether you redeemed it. Poll this after paying.
Needs a key with the `read` permission.'
operationId: getOrdersById
x-tenzro-scope: read
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
example:
id: ord_4hYt2K9qLmN0pXr8
type: credits
title: Credit top-up · any machine
amount_usd: 25
currency: usd
status: paid
machine_id: null
payment:
method: null
pay_url: https://platform.tenzro.xyz/checkout/ord_4hYt2K9qLmN0pXr8
created_at: '2026-09-26T08:00:00.000Z'
paid_at: '2026-09-26T08:03:00.000Z'
ticket: null
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
scope:
type: string
description: 'On a 403: the permission the key lacks.'
securitySchemes:
apiKey:
type: http
scheme: bearer
description: A Tenzro Labs API key (tzl_…).
ingestKey:
type: http
scheme: bearer
description: 'A Fieldwork ingest key (tzi_…): bound to one project and the origins listed on it, able only to run the participant flow. Safe in a browser. Create it with POST /fieldwork/projects/{id}/ingest-keys.'
serviceAssertion:
type: http
scheme: bearer
bearerFormat: JWT
description: 'A Tenzro Labs service''s ES256 assertion: header kid = the RFC 7638 thumbprint of a key in the service''s published JWKS; iss = sub = the service; aud = this endpoint; exp at most 60 s after iat; jti used once.'