---
updatedAt: 2026-05-11T17:50:33.000Z
agentTools:
  projectIndex: https://developer.greendot.com/embedded-finance/llms.txt
---

# List barcodes by customer

Retrieves barcodes by customer in the specified date range.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "v2",
    "title": "Cash Deposits and Payments"
  },
  "paths": {
    "/v1/Barcode/sender_customer_ref/{sender_customer_ref}/start_date/{start_date}/end_date/{end_date}": {
      "get": {
        "tags": [
          "Barcode"
        ],
        "summary": "List barcodes by customer",
        "description": "Retrieves barcodes by customer in the specified date range.",
        "operationId": "Barcode_InquireBarCodeBySenderRef",
        "parameters": [
          {
            "name": "x-gdn-programnumber",
            "in": "header",
            "description": "Program Number",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-gdn-channeltype",
            "in": "header",
            "description": "Channel Type",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-gdn-longitude",
            "in": "header",
            "description": "Longitude",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-gdn-latitude",
            "in": "header",
            "description": "Latitude",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-gdn-devicetype",
            "in": "header",
            "description": "Device Type",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-gdn-deviceid",
            "in": "header",
            "description": "Device ID",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-gdn-messageid",
            "in": "header",
            "description": "Message ID",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-gdn-sessionid",
            "in": "header",
            "description": "Session Id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-gdn-encryptiontype",
            "in": "header",
            "description": "Encryption Type",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-gdn-signature",
            "in": "header",
            "description": "Signature hash",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-gdn-ipaddress",
            "in": "header",
            "description": "Client IP Address",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-gdn-timestamp",
            "in": "header",
            "description": "UTC Timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sender_customer_ref",
            "in": "path",
            "description": "Customer id of sender",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start_date",
            "in": "path",
            "description": "Start date has to be given in the specific format as \"yyyy-MM-dd\" Ex: July 2nd 2015 will be given as \"2015-07-02\"",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end_date",
            "in": "path",
            "description": "end date has to be given in the specific format as \"yyyy-MM-dd\" Ex: Aug 3nd 2015 will be given as \"2015-08-03\" And it should not greater than the current date.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/BarcodeListInquiryResponse"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/BarcodeListInquiryResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BarcodeListInquiryResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/BarcodeListInquiryResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://partners.dev.nextestate.com/GDCPartners/API"
    }
  ],
  "components": {
    "schemas": {
      "BarcodeListInquiryResponse": {
        "description": "",
        "type": "object",
        "properties": {
          "Barcodes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BarcodeInfo"
            }
          },
          "gd_search_count": {
            "format": "int32",
            "type": "integer"
          },
          "partner_transaction_reference": {
            "description": "partner_transaction_reference\r\nTransactionReference of the partner if the partner passes this information",
            "type": "string"
          },
          "gd_transaction_reference": {
            "description": "gd_transaction_reference\r\nUnique reference for this transaction generated by Gd",
            "type": "string"
          },
          "gd_response_code": {
            "format": "int32",
            "description": "gd_response_code",
            "type": "integer"
          },
          "gd_response_message": {
            "description": "gd_response_message\r\nCustom text describing the success or failure of the API.",
            "type": "string"
          },
          "gd_response_date": {
            "format": "date-time",
            "description": "gd_response_date\r\nResponse date time in UTC",
            "type": "string"
          }
        }
      },
      "BarcodeInfo": {
        "description": "",
        "type": "object",
        "properties": {
          "gd_barcode_id": {
            "description": "Barcode number or Barcode link code based on the type of barcode generated",
            "type": "string"
          },
          "gd_barcode_id_expiration": {
            "format": "date-time",
            "description": "Expiration datetime of the barcode or barcode link based on the type selected",
            "type": "string"
          },
          "gd_retailer_key": {
            "format": "int32",
            "description": "Retailer selected for generating the barcode",
            "type": "integer"
          },
          "gd_retailer_name": {
            "description": "Retailer Name as per GD system",
            "type": "string"
          },
          "gd_barcode_change_date": {
            "format": "date-time",
            "description": "Last Change DateTime of the barcode",
            "type": "string"
          },
          "sender_customer_ref": {
            "description": "It is echo of sender_customer_ref field which is received as part of input.",
            "type": "string"
          },
          "gd_barcode_status": {
            "format": "int32",
            "description": "1 = New,2 = Pending,3 = Consumed,4 = Voided,5 = Expired,6 = Cancelled,7 =  Declined",
            "type": "integer"
          },
          "amount": {
            "format": "double",
            "description": "Amount if it is associated with the barcode at the time of generation or if the barcode is consumed",
            "type": "number"
          }
        }
      }
    }
  }
}
```