> ## Documentation Index
> Fetch the complete documentation index at: https://api.csboard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/sources — Suppliers by Number

> The supplier numbers listings carry in `source`: how many listings each has, how they are delivered and what a Steam reversal returns.

Lists the suppliers behind the shelf. Each one is a number, the same number every listing carries in `source`. There are no names: a number always means the same supplier and is never reused, and you learn what it is worth to you by comparing its listings with what you already buy elsewhere.

Use it to decide which suppliers to leave out, then save the choice with [`PUT /v1/account/sources_off`](https://api.csboard.com/api-reference/put-account-sources-off) or pass `sources_off` on a request.

**Authentication required.** Send your key as `Authorization: Bearer csb_pub_...`. No balance is needed.

## Query parameters

**appId** `integer` (default: 730)

Game to read: `730` = CS2, `570` = Dota 2, `252490` = Rust.

## Response

**data.sources** `object[]` *required*

One entry per supplier that has listings right now, ordered by number.

**Source object**

**source** `integer` *required*

The supplier's number.

**listings** `integer` *required*

Listings on the shelf from this supplier.

**delivery** `string[]` *required*

The delivery kinds its listings have: `instant`, `up_to_12h`, `hold`.

**refund\_percent** `object | null`

`min` and `max` of `refund_percent` among its listings. `null` when none of them has a figure.

**off** `boolean` *required*

`true` when your account has this supplier switched off.

**data.updated\_at** `datetime` *required*

When the counts were taken. They are refreshed about every 10 minutes.

## Example request

```bash theme={null}
curl "https://csboard.com/v1/sources" \
  -H "Authorization: Bearer csb_pub_..."
```

## Example response

```json theme={null}
{
  "data": {
    "sources": [
      { "source": 101, "listings": 11400, "delivery": ["up_to_12h"], "refund_percent": null, "off": false },
      { "source": 103, "listings": 41300, "delivery": ["instant"], "refund_percent": { "min": 50, "max": 50 }, "off": false },
      { "source": 107, "listings": 1450000, "delivery": ["instant", "up_to_12h"], "refund_percent": { "min": 0, "max": 100 }, "off": true }
    ],
    "updated_at": "2026-11-22T10:20:00.000Z"
  }
}
```

## Error codes

| HTTP status | Code | Meaning |
| - | - | - |
| 400 | `unsupported_game` | Your key cannot use this `appId`. |
| 401 | `missing_api_key`, `invalid_api_key` | Missing or invalid API key. |
| 429 | `rate_limit_exceeded` | Over your key's per-minute limit. |


## OpenAPI

````yaml GET /sources
openapi: 3.1.0
info:
  title: CSBoard API
  version: 1.0.0
  description: >-
    Market data over the CSBoard marketplace — live listings, floats, stickers,
    minAsk prices, FX rates — plus opt-in buying straight from your balance.
    Free to read, key-gated, built for automation.
  contact:
    name: CSBoard
    url: https://csboard.com/docs
servers:
  - url: https://csboard.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Status
    description: Liveness and freshness probes.
  - name: Market data
    description: Read the live catalog, prices, and FX rates.
  - name: Trading
    description: Buy listings from your CSBoard balance. Opt-in, key-gated.
  - name: Instant Sell
    description: >-
      Sell CS2, Dota 2 and Rust items from any Steam inventory to the CSBoard
      network and get paid to your balance. Invite-only.
  - name: P2P
    description: >-
      List your own CS2 skins on the CSBoard P2P market. Free — any valid key,
      no balance requirement.
  - name: Merchant lots
    description: >-
      List items that sit in your own Steam accounts, take an order call when
      one sells, report the trade yourself. Off until we switch it on for your
      account. See the Merchant Lots guide.
  - name: Account
    description: Your balance, settled funds, and trading status.
  - name: Webhooks
    description: Register an endpoint and receive signed order updates instead of polling.
paths:
  /sources:
    get:
      tags:
        - Market data
      summary: Suppliers by number
      description: >-
        The suppliers behind the shelf, each as the number listings carry in
        `source`: how many listings it has, how they are delivered and what a
        Steam reversal returns on them. There are no names; a number always
        means the same supplier. Key only — no balance requirement. Counts are
        refreshed about every 10 minutes.
      operationId: listSources
      parameters:
        - $ref: '#/components/parameters/AppId'
      responses:
        '200':
          description: Suppliers that have listings right now, ordered by number.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    required:
                      - sources
                      - updated_at
                    properties:
                      sources:
                        type: array
                        items:
                          $ref: '#/components/schemas/Source'
                      updated_at:
                        type: string
                        format: date-time
                        description: When the counts were taken.
              example:
                data:
                  sources:
                    - source: 101
                      listings: 11400
                      delivery:
                        - up_to_12h
                      refund_percent: null
                      'off': false
                    - source: 103
                      listings: 41300
                      delivery:
                        - instant
                      refund_percent:
                        min: 50
                        max: 50
                      'off': false
                    - source: 107
                      listings: 1450000
                      delivery:
                        - instant
                        - up_to_12h
                      refund_percent:
                        min: 0
                        max: 100
                      'off': true
                  updated_at: '2026-11-22T10:20:00.000Z'
        '400':
          description: '`unsupported_game`: this key cannot use the `appId`.'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  parameters:
    AppId:
      name: appId
      in: query
      required: false
      description: >-
        Steam appId of the game. `730` = CS2 (the default), `570` = Dota 2,
        `252490` = Rust. Omit it and the endpoint answers for CS2 exactly as
        before. An appId this key may not use answers `400 unsupported_game`,
        whose `supported_app_ids` lists the ones it may — see `GET /games`.
      schema:
        type: integer
        enum:
          - 730
          - 570
          - 252490
        default: 730
  schemas:
    Source:
      type: object
      required:
        - source
        - listings
        - delivery
        - 'off'
      properties:
        source:
          type: integer
          description: The supplier's number.
          example: 107
        listings:
          type: integer
          description: Listings on the shelf from this supplier.
          example: 1450000
        delivery:
          type: array
          items:
            type: string
            enum:
              - instant
              - up_to_12h
              - hold
          description: The delivery kinds its listings have.
        refund_percent:
          type:
            - object
            - 'null'
          description: >-
            Lowest and highest `refund_percent` among its listings. `null` when
            none of them has a figure.
          properties:
            min:
              type: number
            max:
              type: number
        'off':
          type: boolean
          description: '`true` when your account has this supplier switched off.'
    Error:
      type: object
      description: >-
        All errors return { code, detail }. Some carry extra fields (e.g.
        price_moved adds current_total_usd, insufficient_balance adds
        required_usd/current_usd, item_unavailable adds unavailable_ids and, on
        CS2 buys, unknown_ids).
      properties:
        code:
          type: string
          description: >-
            Machine-readable error code, e.g. rate_limit_exceeded,
            trading_not_enabled, price_moved.
        detail:
          type: string
          description: Human-readable explanation.
      required:
        - code
    RateLimitError:
      type: object
      description: >-
        The `429` body of a per-key bucket. Endpoint-specific limits send only
        `code` and `detail`.
      properties:
        code:
          type: string
          description: >-
            `rate_limit_exceeded` for the key's buckets. Endpoint-specific
            limits use their own code (`snapshot_rate_limited`, `rate_limited`).
        detail:
          type: string
          description: Human-readable explanation.
        bucket:
          type: string
          enum:
            - read
            - trading
            - buy_orders
          description: Which bucket is spent.
        limit_per_min:
          type: integer
          description: That bucket's ceiling per minute.
        retry_after_sec:
          type: integer
          minimum: 1
          maximum: 60
          description: >-
            Seconds until the window restarts — the same number as
            `Retry-After`.
      required:
        - code
  responses:
    Unauthorized:
      description: Missing or invalid API key (`missing_api_key` or `invalid_api_key`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: missing_api_key
            detail: >-
              Provide your API key via `Authorization: Bearer csb_pub_…`.
              Generate one at https://csboard.com/profile?tab=api
    RateLimited:
      description: >-
        A per-key limit is spent. The key's own buckets answer
        `rate_limit_exceeded` with `bucket` (`read`, `trading` or `buy_orders`),
        `limit_per_min` and `retry_after_sec`. `Retry-After` is the seconds left
        until the one-minute window restarts (1–60), not a flat 60.
        Endpoint-specific limits (`snapshot_rate_limited` on the price snapshot,
        `rate_limited` on Instant Sell) send only `code` and `detail`.
      headers:
        Retry-After:
          description: >-
            Seconds until the one-minute window restarts (1–60). Waiting that
            long is always enough.
          schema:
            type: integer
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
        X-RateLimit-Bucket:
          $ref: '#/components/headers/X-RateLimit-Bucket'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimitError'
          example:
            code: rate_limit_exceeded
            detail: >-
              Read rate limit of 100 requests/min exceeded. The counter restarts
              in 23 s. For new listings use GET /v1/listings/stream instead of
              polling.
            bucket: read
            limit_per_min: 100
            retry_after_sec: 23
  headers:
    X-RateLimit-Limit:
      description: >-
        The ceiling per minute of the bucket this call spent (named in
        `X-RateLimit-Bucket`).
      schema:
        type: integer
      example: 3000
    X-RateLimit-Remaining:
      description: Calls left on that bucket in the current one-minute window.
      schema:
        type: integer
        minimum: 0
      example: 2987
    X-RateLimit-Reset:
      description: >-
        Seconds until the one-minute window restarts and the counter starts
        again.
      schema:
        type: integer
        minimum: 1
        maximum: 60
      example: 41
    X-RateLimit-Bucket:
      description: >-
        The bucket this call spent: `read` (reads and every other keyed call) or
        `trading` (buys, order reads, claims, cancels, balance). A `429` from
        the buy-order limit says `buy_orders`.
      schema:
        type: string
        enum:
          - read
          - trading
          - buy_orders
      example: trading
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Send your key as a Bearer token on every request: `Authorization: Bearer
        csb_pub_...`. Generate keys in your CSBoard profile. Calls made with a
        key are metered only by that key's own limits — there is no per-IP limit
        on top — and every answer carries `X-RateLimit-Limit`,
        `X-RateLimit-Remaining`, `X-RateLimit-Reset` and `X-RateLimit-Bucket`
        for the bucket the call spent. See [Rate limits](/rate-limits).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.