Skip to main content
GET
/
invoice-lookup
curl --request GET \
  --url 'https://api.alguna.io/invoice-lookup?reference=INV-001' \
  --header 'Authorization: Bearer YOUR_API_KEY'

{
  "invoiceId": "inv_abc123def456"
}
Look up an invoice’s ID using its external reference number. This is useful when you have the customer-facing invoice reference (e.g. “INV-001”) and need to find the corresponding Alguna invoice ID to perform actions like marking it as paid.

​
Query Parameters

​
reference
string
required
The external reference number of the invoice. This is the customer-facing invoice number assigned on issuance.

​
Response

​
invoiceId
string
The Alguna invoice ID corresponding to the provided reference.

​
Example

curl --request GET \
  --url 'https://api.alguna.io/invoice-lookup?reference=INV-001' \
  --header 'Authorization: Bearer YOUR_API_KEY'

{
  "invoiceId": "inv_abc123def456"
}