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

# Retrieve Store Information for Barcode Simulation

> > ⚠️ Sandbox Only > This simulation endpoint is only available in sandbox environments and will not be available in production.
Retrieve store information for a barcode transaction simulation




## OpenAPI

````yaml openapi-v1.json get /cash/transaction_simulations/barcodes/stores
openapi: 3.0.3
info:
  description: >-
    This is the official reference documentation for Synctera APIs. If you need
    something specific or have a question, <a class='text-blue-600'
    href='https://synctera.com/contact-us' target='_blank'
    rel='noreferrer'>contact us</a>.</p>
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  title: Synctera API
  version: 1.191.0
servers:
  - description: Production
    url: https://api.synctera.com/v1
  - description: Sandbox (no real world financial impact)
    url: https://api-sandbox.synctera.com/v1
security:
  - bearerAuth: []
tags:
  - description: |
      Requests to create and manage Rewards
    name: Rewards (beta)
  - description: Requests to generate simulated webhooks
    name: Card Webhook Simulations
  - description: >-
      Testing endpoints to simulate in-store cash deposits. Available in sandbox
      environments only.
    name: In-Store Cash Deposit Simulations
  - description: Create and manage spending controls
    name: Spend Controls (beta)
  - description: Rates
    name: Rates
  - description: Requests to create and manage webhooks
    name: Webhooks
  - description: Tenant Config
    name: Tenant Config
  - description: FDX authentication and data transfer using Plaid Core Exchange
    name: Plaid Core Exchange (beta)
  - description: Create and manage disputes
    name: Disputes
  - description: Requests to simulate card payments
    name: Card Simulations
  - description: >-
      Aggregated write-off amounts for lending accounts, computed from posted
      transactions.
    name: Write Off Amounts
  - description: |
      Manage fee products and fee configs for automated fee collection
    name: Fee Products
  - description: Apple Pay APIs
    name: Apple Pay
  - description: Lending Config
    name: Lending Config
  - description: Payments related to lending accounts
    name: Payments
  - description: Manage negative balance processes
    name: Negative Balance
  - description: Configuration for mapping LoanPro events to Payola transaction parameters
    name: LoanPro Transaction Event Config
  - description: Requests to generate simulated transactions
    name: Cash Transaction Simulations (alpha)
  - description: Create and manage transactions
    name: Transactions (beta)
  - description: Autopay payment records for billing periods
    name: Autopays
  - description: Create and manage accounts
    name: Accounts
  - description: |
      Requests to create and manage batch payments
    name: Batch Payments (alpha)
  - description: Billing rates
    name: Billing Rates
  - description: Bank Delinquency Configuration
    name: Bank Delinquency Configuration
  - description: >-
      Rules that map a posted payment transaction (bank/partner + transaction
      attributes) to a regulatory payment code. NULL match columns act as
      wildcards.
    name: Payment Code Configuration
  - description: Create and manage Synctera Pay templates
    name: SyncteraPay
  - description: |
      Manage reward products and reward configs for automated cashback rewards
    name: Reward Products
  - description: Requests to create and manage card disputes
    name: Card Disputes
  - description: >-
      Per bank/partner account-type mapping to FFIEC collateral codes used for
      regulatory call report furnishment.
    name: Collateral Code Configuration
  - description: Bulk card issuance
    name: Bulk Issuance
  - description: Autopay configuration management for lending accounts
    name: Autopay Configs
  - description: Request to create and manage exclusions
    name: Statements
  - description: Create and manage barcodes for in-store cash deposits
    name: In-Store Cash Deposits
  - description: Customer Service Details for disputes and billing inquiries
    name: Customer Service Details
  - description: Create a credit application.
    name: Applications (beta)
  - description: Requests to generate simulated transactions
    name: Card Transaction Simulations
  - description: Billing period summaries
    name: Billing Period Summaries
  - description: Requests to issue and manage cards
    name: Cards
  - description: Push and pull from cards
    name: External Cards
  - description: |
      Requests to create and manage fees
    name: Fees (beta)
paths:
  /cash/transaction_simulations/barcodes/stores:
    get:
      tags:
        - In-Store Cash Deposit Simulations
      summary: Retrieve Store Information for Barcode Simulation
      description: >
        > ⚠️ Sandbox Only > This simulation endpoint is only available in
        sandbox environments and will not be available in production.

        Retrieve store information for a barcode transaction simulation
      operationId: getBarcodeSimulationStore
      parameters:
        - in: query
          name: limit
          schema:
            default: 50
            description: >-
              Maximum number of stores to return per page. Must be between 1 and
              10000.
            maximum: 10000
            minimum: 1
            type: integer
        - in: query
          name: radius
          schema:
            default: 5
            description: >-
              Radius in miles to search for stores. Must be between 0.1 and 25
              miles.
            format: float
            maximum: 25
            minimum: 0.1
            type: number
        - in: query
          name: lat
          required: true
          schema:
            description: Latitude of the store location for simulation
            example: 37.7749
            format: float
            type: number
        - in: query
          name: lng
          required: true
          schema:
            description: Longitude of the store location for simulation
            example: -122.4194
            format: float
            type: number
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/barcode_simulation_store_response'
          description: Successful retrieval of store information
        '400':
          $ref: '#/components/responses/bad_request'
        '401':
          $ref: '#/components/responses/unauthorized'
        '403':
          $ref: '#/components/responses/forbidden'
        '422':
          $ref: '#/components/responses/unprocessable_entity'
        '500':
          $ref: '#/components/responses/internal_server_error'
components:
  schemas:
    barcode_simulation_store_response:
      properties:
        stores:
          items:
            $ref: '#/components/schemas/barcode_simulation_store'
          type: array
      required:
        - stores
      type: object
    barcode_simulation_store:
      properties:
        address:
          $ref: '#/components/schemas/barcode_simulation_store_address'
        business_name:
          description: Name of the store
          example: Example Store
          type: string
        coordinates:
          $ref: '#/components/schemas/barcode_simulation_store_coordinates'
        distance:
          description: Distance from the provided location in miles
          example: 2.5
          format: float
          type: number
        id:
          description: Unique identifier for the store
          example: store_12345
          type: string
      required:
        - address
        - business_name
        - coordinates
        - distance
        - id
      type: object
    error:
      description: Synctera error responses in API v1 implement a custom error schema.
      properties:
        code:
          description: >
            A machine-readable string that identifies the error for programmatic
            use.
          example: BAD_REQUEST_BODY
          type: string
        detail:
          description: |
            A human-readable string explaining this particular error.
          example: 'Missing required fields: first_name, dob'
          type: string
        status:
          description: HTTP status code for this response
          example: 400
          type: integer
      title: Synctera error response
      type: object
    barcode_simulation_store_address:
      properties:
        address1:
          description: First line of the store address
          example: 123 Main St
          type: string
        address2:
          description: Second line of the store address (optional)
          example: Suite 100
          type: string
        city:
          description: City where the store is located
          example: San Francisco
          type: string
        country:
          description: Country where the store is located
          example: US
          type: string
        county:
          description: County where the store is located
          example: San Francisco County
          type: string
        state:
          description: State where the store is located
          example: CA
          type: string
        zip_code:
          description: ZIP code of the store location
          example: '94103'
          type: string
      required:
        - address1
        - city
        - country
        - state
        - zip_code
      type: object
    barcode_simulation_store_coordinates:
      properties:
        latitude:
          description: Latitude of the store location
          example: 37.7749
          format: float
          type: number
        longitude:
          description: Longitude of the store location
          example: -122.4194
          format: float
          type: number
      required:
        - latitude
        - longitude
      type: object
  responses:
    bad_request:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/error'
      description: Bad request
    unauthorized:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/error'
      description: Unauthorized
    forbidden:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/error'
      description: Forbidden
    unprocessable_entity:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/error'
      description: Unprocessable entity
    internal_server_error:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/error'
      description: Internal server error
  securitySchemes:
    bearerAuth:
      bearerFormat: api_key
      scheme: bearer
      type: http

````