---
title: "getAllOpsPaginated offer"
method: GET
path: "/ops/offers/all/paginated"
tags: ["ops"]
---

# getAllOpsPaginated offer

`GET /ops/offers/all/paginated`

Fetch offers with filters on status and seller using cursor pagination

## Query parameters

- `page` integer — Which page number to fetch (zero-indexed)
- `starting_after` string, regexp — A cursor to use in pagination. It will be the starting point of the list and will not be included in the results.
- `ending_before` string, regexp — A cursor to use in pagination. It will be the ending point of the list and will not be included in the results.
- `limit` integer — How many results to return per page.
- `seller_id` string, regexp — Seller ID
- `status` string[] — Offer status
- `seller_offer_reference` string — Partner's own reference for this offer
- `pending_serial_numbers` boolean — Accepted offer that serial number has been pending
- `end_customer_id` string — Id of the end customer
- `contract_entity` string[] — Contract entity

## Response `200`

OK response.

- PaginatedOfferSummaryForOps
  - `data` OfferSummaryForOps[], required — Array of OfferSummaryForOps
    - `agent` SalesAgent — Sales agent related to an offer
      - `email` string, email, required — E-mail
      - `external_agent_id` string — Id number used to identify the sales agent in the seller's internal system
      - `name` string, required — Name of the agent
      - `phone` string, required — Phone number
    - `created_at` string, date-time, required
    - `customer` CustomerInfo, required
      - `company` CompanyInfo, required
        - `billing_address` Address, required
          - `city` string, required — City
          - `country_code` string, required — ISO 3166-1 alpha-2
          - `line1` string, required — First line (street, number, etc.)
          - `line2` string — Second line (flat number, etc.)
          - `postal_code` string, required — Postal code
          - `region` string — Region, county, province, etc.
        - `name` string, required — Name of the company
        - `tax_number` string — Tax Identification Number
        - `type` 'Sole proprietorship' | 'Partnership' | 'Corporation' | 'Limited Liability Company (LLC)' — Type of the company (required for US)
        - `vat_number` string — VAT Registration Number
      - `email` string, email — E-mail that will be used for the account
      - `end_customer_id` string, regexp — topi End Customer ID
      - `full_name` string — Full name of the customer
      - `id` string, regexp — topi ID for the customer
    - `declined_at` string, date-time
    - `expires_at` string, date-time, required
    - `id` string, regexp, required — Offer ID
    - `offer_confirmed_at` string, date-time
    - `order_info` OrderInfo
      - `created_at` string, date-time, required
      - `id` string, regexp, required — Order ID in Topi system
      - `status` 'created' | 'confirmed' | 'acknowledged' | 'accepted' | 'partially_fulfilled' | 'completed' | 'canceled' | 'rejected', required
    - `phone_number` string — Phone number
    - `sales_channel` 'telesales' | 'ecommerce', required
    - `seller_info` SellerInfo, required
      - `address` Address, required
        - `city` string, required — City
        - `country_code` string, required — ISO 3166-1 alpha-2
        - `line1` string, required — First line (street, number, etc.)
        - `line2` string — Second line (flat number, etc.)
        - `postal_code` string, required — Postal code
        - `region` string — Region, county, province, etc.
      - `capability_add_custom_products` boolean, required — If the seller can add custom products
      - `capability_anonymized_pricing` boolean, required — If the seller wishes to anonymize catalog prices
      - `capability_anonymous_ecom_offer_creation` boolean, required — Ability to skip required shipping address for ecom offers.
      - `capability_bundles` boolean, required — If the seller has bundles enabled
      - `capability_chatbot_id` string — Chatbot id for the seller. This enables a chatbase chatbot for the seller
      - `capability_dual_pricing` boolean, required — If true, the seller has the Dual Pricing system enabled
      - `capability_hide_buy_now` boolean, required — If the seller should hide purchase only as option.
      - `capability_international_shipment` boolean, required — If the seller has international shipment enabled
      - `currency` string, required — The currency of the seller
      - `email` string, required — The seller email
      - `id` string, regexp, required — The seller id
      - `logo_url` string — The seller logo
      - `name` string, required — The name of the seller
      - `parent_seller_id` string — the ID of the parent seller, we use this for multipliers
      - `pdf_reader_assistant_id` string — The assistant ID to use for PDF reader, use null to disable PDF reader
      - `pretty_name` string — The pretty, customer-facing name of the seller
      - `product_reference_source` string, required — The seller product reference source
    - `seller_offer_reference` string, required — Partner's own reference for this offer
    - `set_to_pending_review_at` string, date-time
    - `shipping_address` ShippingAddress, required
      - `city` string, required — City
      - `country_code` string, required — ISO 3166-1 alpha-2
      - `line1` string, required — First line (street, number, etc.)
      - `line2` string — Second line (flat number, etc.)
      - `postal_code` string, required — Postal code
      - `recipient_name` string — Full name of the recipient
      - `region` string — Region, county, province, etc.
    - `source` string — Source
    - `status` 'created' | 'voided' | 'accepted' | 'expired' | 'rejected' | 'pending_review' | 'declined', required
    - `total_assets` integer, required — amount of assets in the offer: sum(lines.quantity)
    - `total_value` MoneyAmount, required
      - `currency` string, required — Currency code, see ISO 4127 (https://www.iso.org/iso-4217-currency-codes.html) (supported: EUR, GBP, USD)
      - `gross` integer, required — Gross amount of money, expressed in the minor unit for the currency
      - `net` integer, required — Net amount of money, expressed in the minor unit for the currency
    - `user` UserSummary
      - `email` string, required — the user email
      - `name` string, required — the user complete name
  - `pagination` CursorPageMetadata, required — Metadata about the returned page
    - `has_more` boolean, required — Whether there are more pages

## Other responses

- `400` — BadRequest: Bad Request response.
- `401` — Unauthorized: Unauthorized response.
- `403` — InvalidScopes: Forbidden response.

---

[API](https://skmtc.net/topi/apis/topi-public-api.md) · [All operations](https://skmtc.net/topi/apis/topi-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topi/topi-public-api/revisions/fc745e434b3e/schema)