# Corridors Corridor and payout method information ## Get all corridors > Retrieve a list of all available money transfer corridors (source country to destination country paths). Each corridor includes supported currency pairs, exchange rates, fees (percentage and fixed), and quote expiry settings. Only active corridors are returned. ```json {"openapi":"3.1.0","info":{"title":"Minit Money Enterprise API","version":"1.12.8"},"tags":[{"name":"Corridors","description":"Corridor and payout method information"}],"servers":[{"url":"/api/v1","description":"API v1"},{"url":"/","description":"API v0 (Legacy)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for tenant authentication"}},"schemas":{"CorridorListResponse":{"type":"array","items":{"$ref":"#/components/schemas/CorridorDetails"}},"CorridorDetails":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","INACTIVE"]},"country_source_name":{"type":"string"},"country_source_code":{"type":"string"},"country_source_iso3":{"type":"string"},"country_destination_name":{"type":"string"},"country_destination_code":{"type":"string"},"country_destination_iso3":{"type":"string"},"currencies":{"type":"array","items":{"$ref":"#/components/schemas/CorridorCurrency"}}}},"CorridorCurrency":{"type":"object","properties":{"currency_pair_id":{"type":"string"},"source_currency_name":{"type":"string"},"source_currency_code":{"type":"string"},"destination_currency_name":{"type":"string"},"destination_currency_code":{"type":"string"},"currency_type":{"type":"string","enum":["FIAT","CRYPTO"]},"blockchain_network":{"type":["string","null"]},"fee":{"$ref":"#/components/schemas/CorridorFee"}}},"CorridorFee":{"type":"object","properties":{"fixed_fee":{"type":"number"},"percentage_fee":{"type":"number"},"currency":{"type":"string"}}}}},"paths":{"/corridors":{"get":{"tags":["Corridors"],"summary":"Get all corridors","description":"Retrieve a list of all available money transfer corridors (source country to destination country paths). Each corridor includes supported currency pairs, exchange rates, fees (percentage and fixed), and quote expiry settings. Only active corridors are returned.","operationId":"getCorridors","responses":{"200":{"description":"Successfully retrieved list of active corridors with exchange rates and fees","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorridorListResponse"}}}}}}}}} ``` ## Get corridor details > Retrieve detailed information for a specific corridor by ID. Includes source and destination country information (name, ISO codes), supported currency pairs with exchange rates, fees structure (percentage and fixed fees), and quote expiration settings. ```json {"openapi":"3.1.0","info":{"title":"Minit Money Enterprise API","version":"1.12.8"},"tags":[{"name":"Corridors","description":"Corridor and payout method information"}],"servers":[{"url":"/api/v1","description":"API v1"},{"url":"/","description":"API v0 (Legacy)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for tenant authentication"}},"schemas":{"CorridorDetails":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","INACTIVE"]},"country_source_name":{"type":"string"},"country_source_code":{"type":"string"},"country_source_iso3":{"type":"string"},"country_destination_name":{"type":"string"},"country_destination_code":{"type":"string"},"country_destination_iso3":{"type":"string"},"currencies":{"type":"array","items":{"$ref":"#/components/schemas/CorridorCurrency"}}}},"CorridorCurrency":{"type":"object","properties":{"currency_pair_id":{"type":"string"},"source_currency_name":{"type":"string"},"source_currency_code":{"type":"string"},"destination_currency_name":{"type":"string"},"destination_currency_code":{"type":"string"},"currency_type":{"type":"string","enum":["FIAT","CRYPTO"]},"blockchain_network":{"type":["string","null"]},"fee":{"$ref":"#/components/schemas/CorridorFee"}}},"CorridorFee":{"type":"object","properties":{"fixed_fee":{"type":"number"},"percentage_fee":{"type":"number"},"currency":{"type":"string"}}}}},"paths":{"/corridors/{corridorId}":{"get":{"tags":["Corridors"],"summary":"Get corridor details","description":"Retrieve detailed information for a specific corridor by ID. Includes source and destination country information (name, ISO codes), supported currency pairs with exchange rates, fees structure (percentage and fixed fees), and quote expiration settings.","operationId":"getCorridorDetails","parameters":[{"name":"corridorId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successfully retrieved corridor details including supported currency pairs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorridorDetails"}}}}}}}}} ``` ## Get corridor payout methods > Retrieve a list of all available payout methods for a specific corridor. Payout methods define how money will be delivered to beneficiaries (e.g., bank transfer, mobile money, cash pickup). Each method includes type (BANK\_TRANSFER), name, min/max amounts, and fee information. ```json {"openapi":"3.1.0","info":{"title":"Minit Money Enterprise API","version":"1.12.8"},"tags":[{"name":"Corridors","description":"Corridor and payout method information"}],"servers":[{"url":"/api/v1","description":"API v1"},{"url":"/","description":"API v0 (Legacy)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for tenant authentication"}},"schemas":{"CorridorPayoutMethodListResponse":{"type":"array","items":{"$ref":"#/components/schemas/CorridorPayoutMethodDetails"}},"CorridorPayoutMethodDetails":{"type":"object","properties":{"id":{"type":"string"},"method_type":{"type":"string","enum":["BANK_TRANSFER"]},"name":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"fee":{"$ref":"#/components/schemas/CorridorFee"}}},"CorridorFee":{"type":"object","properties":{"fixed_fee":{"type":"number"},"percentage_fee":{"type":"number"},"currency":{"type":"string"}}}}},"paths":{"/corridors/{corridorId}/payouts":{"get":{"tags":["Corridors"],"summary":"Get corridor payout methods","description":"Retrieve a list of all available payout methods for a specific corridor. Payout methods define how money will be delivered to beneficiaries (e.g., bank transfer, mobile money, cash pickup). Each method includes type (BANK_TRANSFER), name, min/max amounts, and fee information.","operationId":"getCorridorPayoutMethods","parameters":[{"name":"corridorId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successfully retrieved available payout methods for the corridor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorridorPayoutMethodListResponse"}}}}}}}}} ``` ## Get payout method details > Retrieve detailed information for a specific payout method within a corridor. Includes method type, name, minimum and maximum transaction amounts, and fee structure. ```json {"openapi":"3.1.0","info":{"title":"Minit Money Enterprise API","version":"1.12.8"},"tags":[{"name":"Corridors","description":"Corridor and payout method information"}],"servers":[{"url":"/api/v1","description":"API v1"},{"url":"/","description":"API v0 (Legacy)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for tenant authentication"}},"schemas":{"CorridorPayoutMethodDetails":{"type":"object","properties":{"id":{"type":"string"},"method_type":{"type":"string","enum":["BANK_TRANSFER"]},"name":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"fee":{"$ref":"#/components/schemas/CorridorFee"}}},"CorridorFee":{"type":"object","properties":{"fixed_fee":{"type":"number"},"percentage_fee":{"type":"number"},"currency":{"type":"string"}}}}},"paths":{"/corridors/{corridorId}/payouts/{payoutMethodId}":{"get":{"tags":["Corridors"],"summary":"Get payout method details","description":"Retrieve detailed information for a specific payout method within a corridor. Includes method type, name, minimum and maximum transaction amounts, and fee structure.","operationId":"getPayoutMethodDetails","parameters":[{"name":"corridorId","in":"path","required":true,"schema":{"type":"string"}},{"name":"payoutMethodId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successfully retrieved payout method details with configuration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorridorPayoutMethodDetails"}}}}}}}}} ``` ## Get payout method requirements > Retrieve the required fields (questions) for a specific payout method. Requirements may vary based on transaction amount using JSON Logic rules. Each requirement includes field name, mapping name for the payment provider, data type, validation rules, and conditional logic determining when the field is required. ```json {"openapi":"3.1.0","info":{"title":"Minit Money Enterprise API","version":"1.12.8"},"tags":[{"name":"Corridors","description":"Corridor and payout method information"}],"servers":[{"url":"/api/v1","description":"API v1"},{"url":"/","description":"API v0 (Legacy)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for tenant authentication"}},"schemas":{"CorridorPayoutMethodRequirements":{"type":"object","properties":{"sender_requirements":{"type":"array","items":{"$ref":"#/components/schemas/CorridorPayoutMethodRequirement"}},"receiver_requirements":{"type":"array","items":{"$ref":"#/components/schemas/CorridorPayoutMethodRequirement"}}}},"CorridorPayoutMethodRequirement":{"type":"object","properties":{"field_id":{"type":"string"},"field_name":{"type":"string"},"label":{"type":"string"},"one_of":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}}}}]},"value":{"type":"string"},"data_type":{"type":"string"},"value_type":{"type":"string"},"value_regex":{"type":"string"},"require_rule":{"anyOf":[{"type":"boolean"},{"type":"object","properties":{"version":{"type":"string"},"logic":{"type":"object"}}}]},"mapping_field_name":{"type":["string","null"]},"order_id":{"type":["number","null"]}}}}},"paths":{"/corridors/{corridorId}/payouts/{payoutMethodId}/requirements":{"get":{"tags":["Corridors"],"summary":"Get payout method requirements","description":"Retrieve the required fields (questions) for a specific payout method. Requirements may vary based on transaction amount using JSON Logic rules. Each requirement includes field name, mapping name for the payment provider, data type, validation rules, and conditional logic determining when the field is required.","operationId":"getPayoutMethodRequirements","parameters":[{"name":"corridorId","in":"path","required":true,"schema":{"type":"string"}},{"name":"payoutMethodId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successfully retrieved required fields and validation rules for payout method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorridorPayoutMethodRequirements"}}}}}}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.minitmoney.enterprises/raas-api/corridors.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.