> ## Documentation Index > Fetch the complete documentation index at: https://api-reference.hyperswitch.io/llms.txt > Use this file to discover all available pages before exploring further. # Routing - List > List all routing configs ## OpenAPI ````yaml get /routing openapi: 3.0.3 info: title: Hyperswitch - API Documentation description: > ## Get started Hyperswitch provides a collection of APIs that enable you to process and manage payments. Our APIs accept and return JSON in the HTTP body, and return standard HTTP response codes. You can consume the APIs directly using your favorite HTTP/REST library. We have a testing environment referred to "sandbox", which you can setup to test API calls without affecting production data. Currently, our sandbox environment is live while our production environment is under development and will be available soon. You can sign up on our Dashboard to get API keys to access Hyperswitch API. ### Environment Use the following base URLs when making requests to the APIs: | Environment | Base URL | |---------------|------------------------------------| | Sandbox | | | Production | | ## Authentication When you sign up on our [dashboard](https://app.hyperswitch.io) and create a merchant account, you are given a secret key (also referred as api-key) and a publishable key. You may authenticate all API requests with Hyperswitch server by providing the appropriate key in the request Authorization header. | Key | Description | |-----------------|-----------------------------------------------------------------------------------------------| | api-key | Private key. Used to authenticate all API requests from your merchant server | | publishable key | Unique identifier for your account. Used to authenticate API requests from your app's client | Never share your secret api keys. Keep them guarded and secure. contact: name: Hyperswitch Support url: https://hyperswitch.io email: support.global@juspay.io license: name: Apache-2.0 version: 0.1.0 servers: - url: https://sandbox.hyperswitch.io description: Sandbox Environment security: [] tags: - name: Merchant Account description: Create and manage merchant accounts - name: Profile description: Create and manage profiles - name: Merchant Connector Account description: Create and manage merchant connector accounts - name: Payments description: Create and manage one-time payments, recurring payments and mandates - name: Refunds description: Create and manage refunds for successful payments - name: Mandates description: Manage mandates - name: Customers description: Create and manage customers - name: Payment Methods description: Create and manage payment methods of customers - name: Disputes description: Manage disputes - name: API Key description: Create and manage API Keys - name: Payouts description: Create and manage payouts - name: payment link description: Create payment link - name: Routing description: Create and manage routing configurations - name: Event description: Manage events - name: Authentication description: Create and manage authentication - name: Subscriptions description: Subscription management and billing endpoints - name: Card Issuer description: Create and manage card issuers paths: /routing: get: tags: - Routing summary: Routing - List description: List all routing configs operationId: List routing configs parameters: - name: limit in: query description: The number of records to be returned required: false schema: type: integer format: int32 nullable: true minimum: 0 - name: offset in: query description: The record offset from which to start gathering of results required: false schema: type: integer format: int32 nullable: true minimum: 0 - name: profile_id in: query description: The unique identifier for a merchant profile required: false schema: type: string nullable: true responses: '200': description: Successfully fetched routing configs content: application/json: schema: $ref: '#/components/schemas/RoutingKind' '404': description: Resource missing '500': description: Internal server error security: - api_key: [] - jwt_key: [] components: schemas: RoutingKind: oneOf: - $ref: '#/components/schemas/RoutingDictionary' - type: array items: $ref: '#/components/schemas/RoutingDictionaryRecord' RoutingDictionary: type: object description: |- Routing dictionary for a merchant. Contains all routing configurations created by the merchant, along with the currently active routing configuration. required: - merchant_id - records properties: merchant_id: type: string description: |- Unique merchant identifier. Example: ```json "merchant_789" ``` example: merchant_789 active_id: type: string description: |- Currently active routing configuration ID. Example: ```json "routing_abc123" ``` example: routing_abc123 nullable: true records: type: array items: $ref: '#/components/schemas/RoutingDictionaryRecord' description: |- List of all routing configuration records associated with this merchant. RoutingDictionaryRecord: type: object description: |- Metadata record representing a stored routing configuration. Used in routing dictionary listings. required: - id - profile_id - name - kind - description - created_at - modified_at properties: id: type: string description: |- Unique identifier of the routing configuration. Example: ```json "routing_abc123" ``` example: routing_abc123 profile_id: type: string description: |- Profile ID associated with this routing configuration. Example: ```json "profile_123" ``` example: profile_123 name: type: string description: |- Name of the routing configuration. Example: ```json "india_card_routing" ``` example: india_card_routing kind: $ref: '#/components/schemas/RoutingAlgorithmKind' description: type: string description: |- Description of this routing configuration. Example: ```json "Volume split routing for domestic transactions" ``` example: Volume split routing for domestic transactions created_at: type: integer format: int64 description: Creation timestamp (milliseconds since epoch). example: 1718000000000 modified_at: type: integer format: int64 description: Last modification timestamp (milliseconds since epoch). example: 1718050000000 algorithm_for: allOf: - $ref: '#/components/schemas/TransactionType' nullable: true decision_engine_routing_id: type: string description: |- Associated Decision Engine routing identifier (if applicable). Present when routing is linked to an external decision engine. Example: ```json "de_route_456" ``` example: de_route_456 nullable: true RoutingAlgorithmKind: type: string enum: - single - priority - volume_split - advanced - dynamic - three_ds_decision_rule TransactionType: type: string enum: - payment - payout - three_ds_authentication securitySchemes: api_key: type: apiKey in: header name: api-key description: >- Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application. jwt_key: type: http scheme: bearer bearerFormat: JWT ````