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

# Get snapshot fill rates

> Get per-field fill rates for one Bright Data Scraper API snapshot. GET /datasets/v3/snapshot/{id}/fill_rate returns filled, total and percentage per field.

This endpoint shows how often each output field was populated in a single Scraper API snapshot, so you can check data coverage before you download or deliver the results.


## OpenAPI

````yaml api-reference/dca-api get /datasets/v3/snapshot/{snapshot_id}/fill_rate
openapi: 3.1.0
info:
  title: Brightdata API
  description: API for interaction with datasets marketplace
  version: 1.0.0
servers:
  - url: https://api.brightdata.com
security:
  - bearerAuth: []
paths:
  /datasets/v3/snapshot/{snapshot_id}/fill_rate:
    get:
      description: >-
        Returns field-level fill rates for one snapshot. For each output field,
        the response gives the number of records with a populated value
        (`filled`), the number of records evaluated (`total`) and the percentage
        (`fill_rate`).


        To aggregate fill rates across every snapshot of a scraper in a time
        frame, use [Get scraper fill
        rates](/api-reference/scrapers/management-apis/get-fill-rates).
      operationId: getSnapshotFillRate
      parameters:
        - name: snapshot_id
          in: path
          required: true
          description: >-
            ID of the snapshot, returned when the collection was triggered. List
            your snapshots with [Get
            snapshots](/api-reference/scrapers/management-apis/get-snapshots).
          schema:
            type: string
            example: sd_mve1hbze1ctojk1cn9
      responses:
        '200':
          description: Fill rates for the snapshot
          content:
            application/json:
              schema:
                type: object
                properties:
                  snapshot_id:
                    type: string
                    description: ID of the snapshot.
                  dataset_id:
                    type: string
                    description: Dataset ID of the scraper that collected the snapshot.
                  status:
                    type: string
                    description: Status of the snapshot, for example `ready`.
                  fields:
                    type: array
                    description: One entry per output field in the snapshot.
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: Name of the output field.
                        filled:
                          type: integer
                          description: >-
                            Number of records with a populated value for the
                            field.
                        total:
                          type: integer
                          description: Number of records evaluated for the field.
                        fill_rate:
                          type: number
                          description: >-
                            Percentage of evaluated records with a populated
                            value, from `0` to `100`: `filled / total * 100`.
              examples:
                fill_rates:
                  summary: X posts snapshot with four records (subset of fields)
                  value:
                    snapshot_id: sd_mve1hbze1ctojk1cn9
                    dataset_id: gd_lwxkxvnf1cynvib9co
                    status: ready
                    fields:
                      - name: id
                        filled: 4
                        total: 4
                        fill_rate: 100
                      - name: photos
                        filled: 2
                        total: 4
                        fill_rate: 50
                      - name: quoted_post
                        filled: 0
                        total: 4
                        fill_rate: 0
                      - name: tagged_users
                        filled: 1
                        total: 4
                        fill_rate: 25
                      - name: views
                        filled: 3
                        total: 4
                        fill_rate: 75
        '401':
          description: |-
            Missing or invalid API key

            Messages (plain text body):
            - `Credentials are missing`
            - `Invalid credentials`
          content:
            text/plain:
              schema:
                type: string
              examples:
                message:
                  value: Invalid credentials
        '404':
          description: |-
            The snapshot ID does not exist or belongs to another account

            Messages (plain text body):
            - `Snapshot does not exist`
          content:
            text/plain:
              schema:
                type: string
              examples:
                message:
                  value: Snapshot does not exist
        '409':
          description: >-
            Fill rates are not available for this snapshot


            Messages (plain text body):

            - `Fill rate is not available for this snapshot: no successful
            records were collected (collection errors: N)`

            - `Fill rate is not available for this snapshot: field fill
            statistics were not recorded`
          content:
            text/plain:
              schema:
                type: string
              examples:
                message:
                  value: >-
                    Fill rate is not available for this snapshot: no successful
                    records were collected (collection errors: 1)
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Use your Bright Data API Key as a Bearer token in the Authorization
        header.


        **How to authenticate:**

        1. Obtain your API Key from the Bright Data account settings at
        https://brightdata.com/cp/setting/users

        2. Include the API Key in the Authorization header of your requests

        3. Format: `Authorization: Bearer YOUR_API_KEY`


        **Example:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```


        Learn how to get your Bright Data API key:
        https://docs.brightdata.com/api-reference/authentication
      bearerFormat: API Key

````