# Overview

<div style='text-align:center'><img src='/images/logo_viamericas.png' width='60%'/></div><br><br> 

 ViaBlocks API Inbound is a server-to-sever API that enables regulated partners create and track money transfers. The API supports sender and beneficiary onboarding, transaction creation, funding, FX handling, payout execution, and status tracking. The two API calls are POST /transaction/create to submit sender, beneficiary, and transaction details, and POST /transaction/status to retrieve the latest processing status. 

 Inbound transaction is a money transfer created by a partner through this API. It represents funds sent from a sender in the origination country to a beneficiary in the delivery country, and it is tracked from creation through payout using /transaction/status 

Version: 1.0.0

## Servers

Sandbox
```
https://sandbox-viablocks.viamericas.io
```

## Download OpenAPI description

 - [Overview](https://docs2-viablocks.viamericas.io/_bundle/apis/inbound.yaml)

## Transaction

 - [POST /transaction/create](https://docs2-viablocks.viamericas.io/apis/inbound/transaction/paths/~1transaction~1create/post.md): Creates a new inbound cross-border money transfer and registers it in the ViaBlocks platform. ## Purpose Initiates a new remittance transaction with sender, beneficiary, and financial details. ## When
 - [GET /transaction/status](https://docs2-viablocks.viamericas.io/apis/inbound/transaction/paths/~1transaction~1status/get.md): Retrieves the current status and details of a transaction. ## Purpose Returns the real-time status, financial details, compliance information, and tracking data for a specific transaction. ## When to
 - [DELETE /transaction/cancel](https://docs2-viablocks.viamericas.io/apis/inbound/transaction/paths/~1transaction~1cancel/delete.md): Inbound transactions represent money arriving from external sources into the system. ## Purpose Cancels a pending inbound transaction. ## When to Use Use this endpoint when you need to: - Void an inbo
## Catalogs

 - [GET /catalogs/countries/{deliveryCountryISO}/currencies](https://docs2-viablocks.viamericas.io/apis/inbound/catalogs/paths/~1catalogs~1countries~1%7Bdeliverycountryiso%7D~1currencies/get.md): ## Purpose Returns the list of supported currencies for the specified country. ## When to use Use this endpoint to: - Populate currency selection options - Validate corridor currency support before tr
 - [GET /catalogs/countries/{deliveryCountryISO}/identifications](https://docs2-viablocks.viamericas.io/apis/inbound/catalogs/paths/~1catalogs~1countries~1%7Bdeliverycountryiso%7D~1identifications/get.md): ## Purpose Returns the supported identification document types for the specified country. ## When to use Use this endpoint to: - Populate document type selection during onboarding - Enforce corridor-s
 - [GET /catalogs/industry](https://docs2-viablocks.viamericas.io/apis/inbound/catalogs/paths/~1catalogs~1industry/get.md): ## Purpose Returns the supported industry categories and associated job titles used for onboarding and compliance classification. ## When to use Use this endpoint to: - Populate industry/job selection
 - [GET /catalogs/wire-purpose](https://docs2-viablocks.viamericas.io/apis/inbound/catalogs/paths/~1catalogs~1wire-purpose/get.md): ## Purpose Returns the supported remittance purposes (reason for transfer) used for compliance classification and reporting. ## When to use Use this endpoint to: - Populate “purpose of transfer” selec
 - [GET /catalogs/funds-origin](https://docs2-viablocks.viamericas.io/apis/inbound/catalogs/paths/~1catalogs~1funds-origin/get.md): ## Purpose Returns supported source-of-funds options used for compliance and risk classification. ## When to use Use this endpoint to: - Populate “source of funds” selections during onboarding - Stand
 - [GET /catalogs/recipients/relationships](https://docs2-viablocks.viamericas.io/apis/inbound/catalogs/paths/~1catalogs~1recipients~1relationships/get.md): ## Purpose Returns the list of available relationship types between sender and recipient. Used for compliance and KYC data collection. ## When to Use Use this endpoint when you need to: - Populate rel
 - [GET /catalogs/account-types](https://docs2-viablocks.viamericas.io/apis/inbound/catalogs/paths/~1catalogs~1account-types/get.md): ## Purpose Returns the list of available bank account types (e.g., Checking, Savings) used for bank deposit delivery methods. ## When to Use Use this endpoint when you need to: - Populate account type
 - [GET /catalogs/transaction/cancel-reasons](https://docs2-viablocks.viamericas.io/apis/inbound/catalogs/paths/~1catalogs~1transaction~1cancel-reasons/get.md): Get available cancellation reasons ## Purpose Returns the list of available cancellation reasons for transactions. These reasons are required when cancelling a transaction via `DELETE /transaction/can
## Service

 - [POST /service/routing/verify](https://docs2-viablocks.viamericas.io/apis/inbound/service/paths/~1service~1routing~1verify/post.md): Verifies a bank routing number and optionally verifies an associated account. ## Purpose Validates a routing number structure (ABA checksum), retrieves bank details and supported payment networks (ACH
 - [POST /service/account/verify](https://docs2-viablocks.viamericas.io/apis/inbound/service/paths/~1service~1account~1verify/post.md): Verifies the validity and status of a bank account number. ## Purpose Validates that a bank account is open, active, and in good standing before initiating a payment or transaction. ## When to use - B