export/bids

POST/export/bids

Create or reuse a full-day CloudX bid activity export. Losing bid prices are redacted to zero. Requires the reports:read permission.

Request

cURL

curl -X POST "https://provisioning.cloudx.io/api/v1/export/bids" \
  -H "Authorization: Bearer $CLOUDX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-09","app_bundle":"<string>","ad_unit_id":"<string>","country":"<string>","device_os":"iOS","bidder":"<string>","include_non_bids":true,"test_mode":"production"}'

Body

Field	Type	Description
`date`required	`string`	One completed UTC day within the previous 45 days.
`app_bundle`	`string`
`ad_unit_id`	`string`
`country`	`string`	ISO 3166-1 alpha-2 country code.
`device_os`	`string`
`bidder`	`string`
`include_non_bids`	`boolean`	Include no-bid, timeout, and error rows in addition to bid responses.
`test_mode`	`string`

Responses

An identical export is ready.

{
  "export_id": "<string>",
  "status": "processing",
  "url": "<string>",
  "expires_at": "<string>"
}

200An identical export is ready.

Field	Type	Description
`export_id`required	`string`
`status`required	`string`
`url`	`string<uri>`	Short-lived signed download URL, present only when ready.
`expires_at`	`string<date-time>`	Signed URL expiry, present only when ready.

202The export is queued or processing.

Field	Type	Description
`export_id`required	`string`
`status`required	`string`
`url`	`string<uri>`	Short-lived signed download URL, present only when ready.
`expires_at`	`string<date-time>`	Signed URL expiry, present only when ready.

400Invalid request parameters.

Field	Type	Description
`error`required	`string`

401Unauthorized.

Field	Type	Description
`error`required	`string`

403Forbidden.

Field	Type	Description
`error`required	`string`

409The account already has the maximum number of active exports.

Field	Type	Description
`error`required	`string`

500Internal server error.

Field	Type	Description
`error`required	`string`