> ## 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 E-Way Bills by generation date

> Fetch e-way bills generated on a date and assigned to your transporter GSTIN, with vehicle history.

## NIC validations

> [accordion] View NIC validations
>
> 1. The generation date must be valid.
> 2. Only active e-way bills are returned.
> 3. Generator state codes must be valid.
> 4. The NIC list API allows 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).

#### Response schema

Schema of the JSON file at `data.json_url`, including vehicle history and lookup errors.

> [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/by-generated-date
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/by-generated-date:
    get:
      tags:
        - E-Way Bill1
        - Transporter
      summary: Get enriched E-Way Bills by generation date
      description: >-
        Fetch e-way bills generated on a date and assigned to your transporter
        GSTIN, with vehicle history.
      operationId: getEnrichedTransporterEWayBillsByGeneratedDate
      parameters:
        - name: date
          in: query
          description: Generation date in DD/MM/YYYY format. Pass one valid calendar date.
          required: true
          example: 04/11/2026
          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}$
        - name: state_codes
          in: query
          description: >-
            Generator state codes, comma-separated. Omit to fetch all supported
            states.
          required: false
          example:
            - '24'
            - '27'
          schema:
            type: array
            minItems: 1
            items:
              type: string
              pattern: ^\s*[0-9]{1,2}\s*$
          style: form
          explode: false
        - 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: IRP source used for the request.
          required: false
          example: primary
          schema:
            type: string
      responses:
        '200':
          description: >-
            Returns a signed URL for the enriched JSON file. The file can
            contain state-level errors or bill-level vehicle detail errors.
          content:
            application/json:
              schema:
                properties:
                  data:
                    properties:
                      json_url:
                        description: >-
                          Signed URL for the result JSON, valid for up to one
                          day. Temporary credentials may expire sooner. Files
                          are retained for 30 days.
                        format: uri
                        type: string
                    additionalProperties: false
                    required:
                      - json_url
                    type: object
                  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
              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
                    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
                    transaction_id: df339ff7-65c5-4070-b4b1-508c0add068b
          headers: {}
        '400':
          description: >-
            The date 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
              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: {}
        '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
          headers: {}
        '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
          headers: {}
        '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
          headers: {}
        '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
          headers: {}
        '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
          headers: {}
        '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
          headers: {}
      deprecated: false
      security:
        - EWayBillAccessToken: []
          SandboxApiKey1: []
      x-codeSamples:
        - 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/by-generated-date?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/by-generated-date?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/by-generated-date?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.