> ## Documentation Index > Fetch the complete documentation index at: https://onlytraffic.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Offers > Active CPL offers from partners. ## OpenAPI ````yaml GET /cpl/offers openapi: 3.0.3 info: title: OnlyTraffic Studio API version: 1.0.0 description: >- External API for OnlyTraffic Studio. Manage and retrieve data about your subscribers, CPL orders, and CPC orders. servers: - url: https://studio-api.onlytraffic.com/api/external/v1 security: - ApiKeyAuth: [] tags: - name: Account description: API key holder's wallet, profile, and aggregate state. - name: Accounts description: OnlyFans accounts attached to the API key holder. - name: Agencies description: Agency CRUD and image management. All edits stage in moderation. - name: CPL description: >- Cost-per-lead orders: place, list, cancel, manage settings, browse partner offers. - name: CPC description: Cost-per-click orders and creative management. - name: RevShare description: Revenue-share campaigns and invoices. - name: Swaps description: Two-sided traffic swap orders and offers. - name: Subscribers description: Per-fan delivery feed (cursor-paginated). - name: Transactions description: Per-transaction OF revenue feed (cursor-paginated). paths: /cpl/offers: get: tags: - CPL summary: Offers description: Active CPL offers from partners. operationId: getCplOffers parameters: - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/PageSize' - name: id in: query schema: type: integer minimum: 1 description: >- Filter to a single offer (use to fetch one offer's details via the list endpoint). - name: source in: query schema: type: string maxLength: 32 - name: marketer_uuid in: query schema: type: string format: uuid description: Filter to offers from a specific marketer. - name: partner_level in: query schema: type: string enum: - new - base - pro - expert - name: guaranteed_speed in: query schema: type: string enum: - 'true' - 'false' - '1' - '0' - name: min_price in: query schema: type: number minimum: 0 - name: max_price in: query schema: type: number minimum: 0 - name: available_only in: query schema: type: string enum: - 'true' - 'false' - '1' - '0' - name: sort in: query schema: type: string enum: - recommendation - added_desc - added_asc - price_asc - price_desc - traffic_desc default: recommendation description: >- Sort order. - `recommendation`: platform recommendation (default). - `added_desc`: newest offers first (by offer creation date). - `added_asc`: oldest offers first. - `price_asc`: cheapest first (effective per-fan price after your discount). - `price_desc`: most expensive first (effective per-fan price after your discount). - `traffic_desc`: most traffic first (running aggregate fans delivered in the last 30 days). responses: '200': description: Successful response content: application/json: schema: type: object properties: success: type: boolean example: true data: type: array items: $ref: '#/components/schemas/CplOffer' pagination: $ref: '#/components/schemas/Pagination' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: >- Server error. Body always reads `{success:false, error:"server_error", message:"Server error"}` (no internal details leak). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: parameters: Page: name: page in: query schema: type: integer minimum: 1 default: 1 description: Page number, 1-indexed. example: 1 PageSize: name: page_size in: query schema: type: integer minimum: 1 maximum: 100 default: 50 description: Items per page. Default 50, max 100. example: 50 schemas: CplOffer: type: object description: A CPL offer published by a partner. Public listing fields only. properties: id: type: integer marketer: $ref: '#/components/schemas/Marketer' source: type: string example: instagram description: type: string nullable: true prices: type: array description: >- Effective price steps in USD per fan. Always an array, even for single-price offers (one element). Values already include offer markup and your tier discount. To find the price for an order quantity Q, pick the step with the largest `min_quantity` that is ≤ Q. items: type: object properties: min_quantity: type: integer price: type: number format: float example: - min_quantity: 1000 price: 0.42 - min_quantity: 5000 price: 0.38 min_quantity: type: integer description: Minimum order quantity (fans). max_quantity: type: integer nullable: true description: Maximum order quantity (fans). Null when uncapped. guaranteed: type: object properties: enabled: type: boolean start_day: type: integer nullable: true description: Day index by which the marketer guarantees first delivery. min_speed: type: integer nullable: true description: Minimum daily fan delivery the marketer guarantees. stats: type: object properties: start_days: type: integer nullable: true description: Average days from order acceptance to first fan (capped at 9). completed_rate_percent: type: integer nullable: true description: Share of recent orders that completed (last 30 days). completed: type: object properties: all: type: integer description: Lifetime completed orders for this offer (all clients). my: type: integer description: Your completed orders for this offer. active: type: object properties: all: type: integer description: Currently accepted (in-flight) orders across all clients. my: type: integer description: Your in-flight orders (status = waiting or accepted). speed: type: object properties: total_per_day: type: integer nullable: true description: >- Average fans delivered per day across all concurrent orders (14-day window). per_order_per_day: type: integer nullable: true description: >- Per-order average daily delivery: typical pace one partner can plan around. queue: type: object description: >- Queue state for placing a new order. `is_full=false` and `position=null` means new orders are accepted immediately. properties: is_full: type: boolean position: type: integer nullable: true description: >- Where a new order placed right now would land (1 = first behind the running orders). is_favorited: type: boolean description: Per-client. True if you have starred this offer in your account. note: type: string nullable: true description: >- Per-client private note attached to this offer. Null if you haven't written one. created_at: type: string format: date-time nullable: true created_at_ts: type: integer nullable: true updated_at: type: string format: date-time nullable: true updated_at_ts: type: integer nullable: true Pagination: type: object description: >- Page-based pagination, returned by every list endpoint that isn't a cursor feed. properties: page: type: integer description: Current page number (1-indexed). example: 1 page_size: type: integer description: Number of items per page. Default 50, max 100. example: 50 total: type: integer description: Total number of records matching the filters. example: 150 total_pages: type: integer description: Total pages available. example: 3 has_next: type: boolean description: >- `true` when `page < total_pages` (i.e. there is at least one more page to fetch). example: true ErrorResponse: type: object description: Standard error envelope for all 4xx/5xx responses. required: - success - error - message properties: success: type: boolean enum: - false description: Always false on error responses. error: type: string description: Stable snake_case machine-readable error code. Branch on this. example: validation_failed message: type: string description: >- Human-friendly text. For 5xx this is always the literal `Server error`. For 4xx an actionable validation/auth message is returned. details: type: object nullable: true description: >- Optional per-field diagnostic information. On 422 carries `{: ["error_code", ...]}`. On 402 (`insufficient_balance`) carries `{required, current}`. On 426 (`unpaid_invoices`) carries `{count, total, oldest_date_ts}`. Absent on most other errors. additionalProperties: true retry_after: type: integer nullable: true description: >- Seconds until the next request will succeed. Present only on 429 responses (rate limit). Mirrors the `Retry-After` HTTP header. Marketer: type: object description: >- Mini-snapshot of an offer's owner. Same shape across CPL offers, CPC offers, and revshare campaigns. properties: uuid: type: string format: uuid nullable: true description: Stable public id of the marketer. example: 27f029f3-3e07-42a6-82d3-e5fa3ef81880 display_name: type: string nullable: true display_emoji: type: string nullable: true description: Optional emoji shown next to the partner's name. level: type: string enum: - new - base - pro - expert registered_ago_days: type: integer nullable: true online: type: object nullable: true description: >- Last-active snapshot. `null` when the marketer has never been active. properties: ago: type: string description: Human-friendly relative time, e.g. `2h 5m`. status: type: string enum: - online - recently - offline description: '`online` <30 min, `recently` <24 h, otherwise `offline`.' securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: Your API key from the Studio Dashboard ````