Get Invoice by ID API
Retrieve a specific invoice record using its unique identifier
Billing
Get Invoice by ID API
Fetch a specific invoice using its unique identifier. Access complete billing details for individual transactions.
Single Invoice
Fetch by unique ID.
Quick Lookup
Direct access to records.
Complete Data
Full invoice details.
Endpoint Overview
QUERY
/graphqlRetrieve a specific invoice by its unique identifier. Returns complete billing information for the requested invoice.
Authentication:Bearer Token
Required scopes:admin
Request Parameters
idString!RequiredThe unique identifier of the invoice to retrieve.
GraphQL Query
query getInvoiceById($id: String!) {
getInvoiceById(id: $id) {
id
firstName
lastName
clientCompanyName
address
taxId
email
phoneNumber
groupId
amountForGroup
multiLogin
amountForMultiLogin
totalAmount
paymentMethod
paymentDate
invoiceDate
updateDate
}
}Variables:
{
"id": "inv_12345"
}HTTP Request:
curl -X POST https://api.orbnet.com/graphql \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
-d '{
"query": "query getInvoiceById($id: String!) { getInvoiceById(id: $id) { id firstName lastName email totalAmount paymentMethod paymentDate } }",
"variables": {
"id": "inv_12345"
}
}'Response
200Invoice Retrieved Successfully
{
"data": {
"getInvoiceById": {
"id": "inv_12345",
"firstName": "John",
"lastName": "Doe",
"clientCompanyName": "Acme Corp",
"address": "123 Business St, New York, NY 10001",
"taxId": "TAX123456",
"email": "john.doe@example.com",
"phoneNumber": "+1234567890",
"groupId": "100",
"amountForGroup": 29.99,
"multiLogin": "3",
"amountForMultiLogin": 5.99,
"totalAmount": 35.98,
"paymentMethod": "stripe",
"paymentDate": "2024-01-15T10:30:00Z",
"invoiceDate": "2024-01-15T10:30:00Z",
"updateDate": "2024-01-15T10:30:00Z"
}
}
}400Invoice Not Found
{
"errors": [
{
"message": "Invoice with ID 'inv_12345' not found",
"path": ["getInvoiceById"],
"extensions": {
"code": "NOT_FOUND"
}
}
],
"data": null
}Use Cases
Customer Support
Look up invoice for support requests.
Receipt Generation
Generate customer receipts.
Payment Verification
Confirm payment details.
Refund Processing
Access data for refunds.
Related Endpoints
Invoice ID Format
Invoice IDs typically follow the format "inv_XXXXX". Ensure you use the complete ID including the prefix.
Search by Payment ID Instead?
If you have the payment transaction ID, use the Get Invoice by Payment ID endpoint.