Create Order | Respona API

curl -X POST https://api.respona.com/rest/api/v1/orders \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "placements": [
    {
      "requested_url": "string",
      "quality_tier": "DR_20"
    }
  ]
}'

{
  "order_id": "string",
  "title": "string",
  "status": "DRAFT",
  "placements": [
    {
      "placement_id": "string",
      "status": "DRAFT",
      "requested_url": "string",
      "requested_anchor": "string",
      "quality_tier": "DR_20",
      "price": 1,
      "price_breakdown": [
        {
          "code": "string",
          "amount": 1
        }
      ],
      "number": "string",
      "publisher_url": "string",
      "content_guidelines": "string",
      "domain_specifications": "string"
    }
  ],
  "price": 1,
  "price_breakdown": [
    {
      "code": "string",
      "amount": 1
    }
  ],
  "created_at": "string",
  "updated_at": "string",
  "number": "string",
  "launched_at": "string",
  "credits_charged": 1
}

Authentication

x-api-keystring

Server-to-server API key. Never embed in a browser or mobile client.

Request

This endpoint expects an object.

placementslist of objectsRequired

titlestringOptional

Optional order title (max 255 chars). Defaults to “New order” when omitted.

Response

order_idstring

titlestring

Order title. Defaults to "New order" when none was supplied on creation.

statusenum

Current order status. One of: DRAFT, LAUNCHED, IN_PROGRESS, COMPLETED, REJECTED, REFUNDED.

placementslist of objects

pricelong

Order price in integer USD cents (1 credit = 1 cent).

price_breakdownlist of objects

created_atstring

updated_atstring

numberstring

Human-facing sequential order number. Assigned at launch — omitted while the order is a draft.

launched_atstring

credits_chargedlong