> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Get enriched transporter E-Way Bills

> Fetch transporter e-way bills by assignment or generation date, with vehicle history.

## Validations

> [accordion] View validations
>
> 1. `date` must be a valid calendar date in `DD/MM/YYYY` format.
> 2. `date_type` must be `assigned_at` or `generated_at`.
> 3. Only active e-way bills are returned.
> 4. `state_codes`, when provided, must contain valid generator state codes separated by commas. Omission selects all supported states.
> 5. List lookups allow 50 requests per 15-minute window, starting with the first request. Further requests return error `658` until the window ends.
>
> Vehicle-history lookups also follow the [Get E-Way Bill validations](https://developer.sandbox.co.in/api-reference/gst/compliance/endpoints/e-way-bill/common/get_e_way_bill.md#nic-validations).

## JSON schema

> [card] [View JSON schema](https://developer.sandbox.co.in/data/gst/schema/request/e-way-bill/enriched-transporter-bills.json)


## OpenAPI

````yaml api-reference/gst/compliance/openapi.json GET /gst/compliance/enriched/e-way-bill/transporter/bills
openapi: 3.0.1
info:
  title: compliance
  description: >-
    **GST Compliance API** enables businesses to automate compliance
    requirements like [Taxpayer
    verification](https://developer.sandbox.co.in/reference/search-gstin-api),
    [GSTR
    Filing](https://developer.sandbox.co.in/reference/gst-taxpayer-authentication),
    [Generating
    E-Invoices](https://developer.sandbox.co.in/reference/e-invoice-authentication-api),
    and [E-Way
    Bills](https://developer.sandbox.co.in/reference/e-way-bill-authentication-api).We
    provide these APIs from GSTN-authorised GST Suvidha Providers, handling the
    encryption-decryption and signing so you don't have to handle the
    complexities.
  version: 1.0.0
servers:
  - url: https://api.sandbox.co.in
    description: prod
  - url: https://test-api.sandbox.co.in
    description: test
security: []
tags:
  - name: Public
  - name: Taxpayer
  - name: Taxpayer Auth
  - name: Returns
  - name: GSTR-1 Documents
  - name: File GSTR-1
  - name: GSTR-2A Documents
  - name: GSTR-2B Document
  - name: File GSTR-3B
  - name: GSTR-4
  - name: File GSTR-9
  - name: Invoice Management System
  - name: GSTR-1A Documents
  - name: File GSTR-1A
  - name: Ledgers
  - name: e-Invoice
  - name: Sales e-Invoices for return period
  - name: Purchase e-Invoices for return period
  - name: Front Office Notices
  - name: Front Office
  - name: AATO
  - name: e-Invoice1
  - name: Authentication
  - name: e-Invoice12
  - name: E-Way Bill
  - name: E-Way Bill1
  - name: Authentication1
  - name: Consignor
  - name: Consolidated E-Way Bill
  - name: Multi-Vehicle Movement
  - name: Consignee
  - name: Transporter
  - name: Consolidated E-Way Bill1
  - name: Multi-vehicle Movement
  - name: Common
paths:
  /gst/compliance/enriched/e-way-bill/transporter/bills:
    get:
      tags:
        - E-Way Bill/Transporter
        - E-Way Bill1
        - Transporter
      summary: Get enriched transporter E-Way Bills
      description: >-
        Fetch transporter e-way bills by assignment or generation date, with
        vehicle history.


        Returns a signed URL in `data.json_url`. The downloaded JSON can include
        list or vehicle-history lookup errors. `data.metadata.usage_count`
        reports the usage units consumed by this request.


        See the [JSON
        schema](/data/gst/schema/request/e-way-bill/enriched-transporter-bills.json)
        and
        [validations](/api-reference/gst/compliance/endpoints/e-way-bill/transporter/get-enriched-bills#validations).
      operationId: getEnrichedTransporterEWayBillsByAssignedDate
      parameters:
        - name: date
          in: query
          description: >-
            A real calendar date in strict DD/MM/YYYY format. Each request
            covers one day.
          required: true
          schema:
            type: string
            minLength: 10
            maxLength: 10
            pattern: ^(0[1-9]|[12][0-9]|3[01])/(0[1-9]|1[0-2])/[0-9]{4}$
          examples:
            Generated-date bills - all states -> 200:
              summary: Generated-date bills - all states -> 200
              value: 04/11/2026
            Generated-date bills - states 24 and 27 -> 200:
              summary: Generated-date bills - states 24 and 27 -> 200
              value: 04/11/2026
            Generated-date bills - empty state member -> 400:
              summary: Generated-date bills - empty state member -> 400
              value: 04/11/2026
            Assigned-date bills - all states -> 200:
              summary: Assigned-date bills - all states -> 200
              value: 04/11/2026
            Assigned-date bills - states 24 and 27 -> 200:
              summary: Assigned-date bills - states 24 and 27 -> 200
              value: 04/11/2026
        - name: date_type
          in: query
          description: >-
            Use assigned_at for assignment date or generated_at for generation
            date.
          required: true
          schema:
            type: string
            enum:
              - assigned_at
              - generated_at
          examples:
            Generated-date bills - all states -> 200:
              summary: Generated-date bills - all states -> 200
              value: generated_at
            Generated-date bills - states 24 and 27 -> 200:
              summary: Generated-date bills - states 24 and 27 -> 200
              value: generated_at
            Generated-date bills - empty state member -> 400:
              summary: Generated-date bills - empty state member -> 400
              value: generated_at
            Assigned-date bills - all states -> 200:
              summary: Assigned-date bills - all states -> 200
              value: assigned_at
            Assigned-date bills - states 24 and 27 -> 200:
              summary: Assigned-date bills - states 24 and 27 -> 200
              value: assigned_at
        - name: state_codes
          in: query
          description: >-
            Generator state codes, comma-separated. Omit to fetch all supported
            states.
          required: false
          schema:
            type: array
            minItems: 1
            items:
              type: string
          style: form
          explode: false
          examples:
            Generated-date bills - states 24 and 27 -> 200:
              summary: Generated-date bills - states 24 and 27 -> 200
              value:
                - '24'
                - '27'
            Generated-date bills - empty state member -> 400:
              summary: Generated-date bills - empty state member -> 400
              value:
                - '24'
                - ''
                - '27'
            Assigned-date bills - states 24 and 27 -> 200:
              summary: Assigned-date bills - states 24 and 27 -> 200
              value:
                - '24'
                - '27'
        - name: x-api-version
          in: header
          description: API version
          required: false
          example: 1.0.0
          schema:
            type: string
            default: 1.0.0
        - name: x-source
          in: header
          description: >-
            NIC server for the session used by this request. `primary` selects
            NIC1. `secondary` selects NIC2. Defaults to `primary`. See [NIC1 and
            NIC2
            routing](/api-reference/gst/compliance/guides/irp/routing#x-source).
          required: false
          example: primary
          schema:
            type: string
            enum:
              - primary
              - secondary
            default: primary
        - name: x-proxy
          in: header
          description: >-
            NIC server that receives the request. If omitted, the request goes
            to the server selected by `x-source`. When specified, selects the
            other server. See [NIC1 and NIC2
            routing](/api-reference/gst/compliance/guides/irp/routing#x-proxy).
          required: false
          schema:
            type: string
            enum:
              - primary
              - secondary
      responses:
        '200':
          description: >-
            Returns a signed URL for the enriched JSON file and the usage units
            consumed by the request. The file can contain state-level errors or
            bill-level vehicle detail errors.
          content:
            application/json:
              schema:
                properties:
                  data:
                    properties:
                      json_url:
                        description: >-
                          Temporary signed URL for the enriched JSON file. The
                          requested expiry is one day, but temporary credentials
                          can expire sooner. File retention is 30 days and does
                          not extend URL validity.
                        format: uri
                        type: string
                      metadata:
                        type: object
                        additionalProperties: false
                        required:
                          - usage_count
                        properties:
                          usage_count:
                            type: integer
                            format: int64
                            minimum: 0
                            description: >-
                              Usage units consumed by this request. Each list
                              lookup counts as one unit. Vehicle-history lookups
                              count when Sandbox can process NIC's HTTP 200
                              response, including business errors.
                        x-apidog-orders:
                          - usage_count
                        x-apidog-ignore-properties: []
                    additionalProperties: false
                    required:
                      - json_url
                      - metadata
                    type: object
                    x-apidog-orders:
                      - json_url
                      - metadata
                    x-apidog-ignore-properties: []
                  code:
                    type: integer
                    enum:
                      - 200
                  timestamp:
                    description: Response timestamp in Unix milliseconds.
                    type: integer
                  transaction_id:
                    type: string
                additionalProperties: false
                required:
                  - timestamp
                  - transaction_id
                  - code
                  - data
                type: object
                x-apidog-orders:
                  - data
                  - code
                  - timestamp
                  - transaction_id
                x-apidog-ignore-properties: []
              examples:
                Generated-date bills - all states -> 200:
                  summary: Generated-date bills - all states -> 200
                  value:
                    code: 200
                    timestamp: 1793800533813
                    data:
                      json_url: >-
                        https://in-co-sandbox-gst-test-storage.s3.ap-south-1.amazonaws.com/e-way-bill/enriched-transporter-bills.json
                      metadata:
                        usage_count: 40
                    transaction_id: 0cb4f608-7eb1-4cf5-9c8f-3a9509d4111f
                Generated-date bills - states 24 and 27 -> 200:
                  summary: Generated-date bills - states 24 and 27 -> 200
                  value:
                    code: 200
                    timestamp: 1793800537070
                    data:
                      json_url: >-
                        https://in-co-sandbox-gst-test-storage.s3.ap-south-1.amazonaws.com/e-way-bill/enriched-transporter-bills.json
                      metadata:
                        usage_count: 2
                    transaction_id: df339ff7-65c5-4070-b4b1-508c0add068b
                Assigned-date bills - all states -> 200:
                  summary: Assigned-date bills - all states -> 200
                  value:
                    code: 200
                    timestamp: 1793800497095
                    data:
                      json_url: >-
                        https://in-co-sandbox-gst-test-storage.s3.ap-south-1.amazonaws.com/e-way-bill/enriched-transporter-bills.json
                      metadata:
                        usage_count: 40
                    transaction_id: 517ef911-6b21-499d-b67c-05b9890cdee6
                Assigned-date bills - states 24 and 27 -> 200:
                  summary: Assigned-date bills - states 24 and 27 -> 200
                  value:
                    code: 200
                    timestamp: 1793800514633
                    data:
                      json_url: >-
                        https://in-co-sandbox-gst-test-storage.s3.ap-south-1.amazonaws.com/e-way-bill/enriched-transporter-bills.json
                      metadata:
                        usage_count: 2
                    transaction_id: ae3fff35-5f67-4d77-b094-88f817c6ec9e
          headers: {}
          x-apidog-name: OK
          x-apidog-ordering: 0
        '400':
          description: >-
            The date or date_type is missing or invalid, or state_codes contains
            an empty, malformed, or unsupported code. The whole request fails.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    enum:
                      - 400
                  timestamp:
                    description: Response timestamp in Unix milliseconds.
                    type: integer
                  transaction_id:
                    type: string
                  message:
                    type: string
                    description: Error message. The exact text can vary.
                required:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-orders:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-ignore-properties: []
              examples:
                Generated-date bills - empty state member -> 400:
                  summary: Generated-date bills - empty state member -> 400
                  value:
                    code: 400
                    timestamp: 1793800457990
                    message: state_codes must not contain empty entries
                    transaction_id: accd84ad-ce2d-4230-88dd-0364070ff95d
          headers: {}
          x-apidog-name: Bad Request
          x-apidog-ordering: 6
        '401':
          description: The Authorization header is missing.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    enum:
                      - 401
                  timestamp:
                    description: Response timestamp in Unix milliseconds.
                    type: integer
                  transaction_id:
                    type: string
                  message:
                    type: string
                    description: Error message. The exact text can vary.
                required:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-orders:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Unauthorized
          x-apidog-ordering: 4
        '403':
          description: >-
            The API key is missing or invalid, or the credentials do not
            authorize the request. The access token must belong to the supplied
            API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    enum:
                      - 403
                  timestamp:
                    description: Response timestamp in Unix milliseconds.
                    type: integer
                  transaction_id:
                    type: string
                  message:
                    type: string
                    description: Error message. The exact text can vary.
                required:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-orders:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Forbidden
          x-apidog-ordering: 5
        '500':
          description: An internal error prevents the request from completing.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    enum:
                      - 500
                  timestamp:
                    description: Response timestamp in Unix milliseconds.
                    type: integer
                  transaction_id:
                    type: string
                  message:
                    type: string
                    description: Error message. The exact text can vary.
                required:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-orders:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Internal Server Error
          x-apidog-ordering: 7
        '502':
          description: The API cannot process a source response or produce the result file.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    enum:
                      - 502
                  timestamp:
                    description: Response timestamp in Unix milliseconds.
                    type: integer
                  transaction_id:
                    type: string
                  message:
                    type: string
                    description: Error message. The exact text can vary.
                required:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-orders:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Bad Gateway
          x-apidog-ordering: 1
        '503':
          description: The source system is unavailable.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    enum:
                      - 503
                  timestamp:
                    description: Response timestamp in Unix milliseconds.
                    type: integer
                  transaction_id:
                    type: string
                  message:
                    type: string
                    description: Error message. The exact text can vary.
                required:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-orders:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Source unavailable
          x-apidog-ordering: 2
        '504':
          description: >-
            The request exceeds the processing time limit. No download URL is
            returned.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    enum:
                      - 504
                  timestamp:
                    description: Response timestamp in Unix milliseconds.
                    type: integer
                  transaction_id:
                    type: string
                  message:
                    type: string
                    description: Error message. The exact text can vary.
                required:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-orders:
                  - code
                  - timestamp
                  - transaction_id
                  - message
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: Gateway Timedout
          x-apidog-ordering: 3
      deprecated: false
      security:
        - EWayBillAccessToken: []
          SandboxApiKey1: []
      x-codeSamples:
        - lang: bash
          label: Assigned-date bills - all states -> 200
          source: |-
            curl --request GET \
              --url "https://test-api.sandbox.co.in/gst/compliance/enriched/e-way-bill/transporter/bills?date_type=assigned_at&date=04%2F11%2F2026" \
              --header "x-api-version: 1.0.0" \
              --header "x-source: primary" \
              --header "Authorization: ${IRP_ACCESS_TOKEN}" \
              --header "x-api-key: ${API_KEY}"
        - lang: bash
          label: Assigned-date bills - states 24 and 27 -> 200
          source: |-
            curl --request GET \
              --url "https://test-api.sandbox.co.in/gst/compliance/enriched/e-way-bill/transporter/bills?date_type=assigned_at&date=04%2F11%2F2026&state_codes=24%2C27" \
              --header "x-api-version: 1.0.0" \
              --header "x-source: primary" \
              --header "Authorization: ${IRP_ACCESS_TOKEN}" \
              --header "x-api-key: ${API_KEY}"
        - lang: bash
          label: Generated-date bills - all states -> 200
          source: |-
            curl --request GET \
              --url "https://test-api.sandbox.co.in/gst/compliance/enriched/e-way-bill/transporter/bills?date_type=generated_at&date=04%2F11%2F2026" \
              --header "x-api-version: 1.0.0" \
              --header "x-source: primary" \
              --header "Authorization: ${IRP_ACCESS_TOKEN}" \
              --header "x-api-key: ${API_KEY}"
        - lang: bash
          label: Generated-date bills - states 24 and 27 -> 200
          source: |-
            curl --request GET \
              --url "https://test-api.sandbox.co.in/gst/compliance/enriched/e-way-bill/transporter/bills?date_type=generated_at&date=04%2F11%2F2026&state_codes=24%2C27" \
              --header "x-api-version: 1.0.0" \
              --header "x-source: primary" \
              --header "Authorization: ${IRP_ACCESS_TOKEN}" \
              --header "x-api-key: ${API_KEY}"
        - lang: bash
          label: Generated-date bills - empty state member -> 400
          source: |-
            curl --request GET \
              --url "https://test-api.sandbox.co.in/gst/compliance/enriched/e-way-bill/transporter/bills?date_type=generated_at&date=04%2F11%2F2026&state_codes=24%2C%2C27" \
              --header "x-api-version: 1.0.0" \
              --header "x-source: primary" \
              --header "Authorization: ${IRP_ACCESS_TOKEN}" \
              --header "x-api-key: ${API_KEY}"
components:
  securitySchemes:
    EWayBillAccessToken:
      type: apiKey
      in: header
      name: authorization
      description: >-
        E-Way Bill taxpayer access token returned by
        [Authenticate](/api-reference/gst/compliance/endpoints/e-way-bill/authenticate).
    SandboxApiKey1:
      type: apiKey
      in: header
      name: x-api-key
      description: Sandbox API key from your Sandbox account.

````

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