Skip to main content
POST
/
invoices
curl --request POST \
  --url https://api.obiex.finance/v1/invoices \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "targetAmount": 1000,
  "source": "NGNX",
  "target": "USD",
  "fundingSource": "DEPOSIT",
  "purposeOfPayment": "Payment for software development services",
  "invoiceDocument": "https://res.cloudinary.com/afrivelle/image/upload/v1718000000/invoice_abc123.pdf",
  "destination": {
    "accountName": "Acme Corp Account",
    "accountNumber": "12345678901",
    "swiftCode": "FIBKUS33XXX",
    "bankName": "First International Bank",
    "bankCode": "FIBK",
    "bankCountry": "US",
    "bankAddress": "123 Main Street, New York, NY 10001",
    "beneficiaryName": "Acme Corp",
    "beneficiaryAddress": "456 Business Ave, San Francisco, CA 94105",
    "beneficiaryCountryCode": "US",
    "beneficiaryCountryOfResidence": "United States"
  }
}
'
{
  "message": "Ok",
  "data": {
    "invoiceId": "a3f1c2d4-8b0e-4f3a-9c7d-1e2b3a4c5d6e",
    "status": "PENDING",
    "rate": 1625,
    "reference": "INV-REF-2026-001",
    "amountToDeposit": 1625000,
    "targetAmount": 1000,
    "sourceCurrency": "NGNX",
    "targetCurrency": "USD",
    "virtualAccountDetails": {
      "accountName": "Obiex / Acme Corp",
      "accountNumber": "9012345678",
      "bankName": "Providus Bank",
      "expiresAt": "2026-06-10T11:30:00.000Z"
    }
  }
}

Authorizations

x-api-key
string
header
required

Headers

Body

application/json

The body is of type object.

Response

200 - application/json

Invoice created successfully

The response is of type object.