For developers

Order and track from your own system

The same endpoints the yourpost site uses to list services, create orders and record payments. Access is opened per verified account.

Status

Open on request. Register interest with your use case; the team replies with access steps.

Who it is for

Agencies with many clients

Place orders for each client from your own tools.

Teams with a dashboard

Pull order status into the board you already use.

Repeat orders

Your own system can resend a standard order without retyping it.

Endpoints

GET/api/servicesPublic

List active services available to your account.

GET/api/ordersSign-in required

Your orders with status and wallet balance.

POST/api/ordersSign-in required

Create an order. Send an Idempotency-Key header so a retry never creates a duplicate.

POST/api/topupsSign-in required

Record a transfer reference; balance changes only after it is verified.

Example: create an order

curl -X POST https://yourpost.ai/api/orders \
  -H "Authorization: Bearer <session token>" \
  -H "Idempotency-Key: <new uuid per order>" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"<id from /api/services>","quantity":<quantity>}'

Rules

  • Errors come back as JSON with one field: {"error": "…"} and a matching HTTP status.
  • Order creation is limited to 5 requests per hour per address; wait and retry with the same Idempotency-Key.
  • Content still goes through approval before it is posted, the same as orders placed on the site.

Next step

Want access?

Tell us what you want to connect and roughly how many orders a month.