STABLE RELEASE v1.2.4

Bill Tracking API

Programmatically monitor, categorize, and analyze invoice data from Aevum News' global financial network. RESTful endpoints with webhook support, real-time status updates, and enterprise-grade rate limiting.

Authentication

Aevum News API uses Bearer token authentication. Include your API key in the Authorization header for every request. Keys are scoped by environment and can be rotated from the developer dashboard.

HTTP Headers

Authorization: Bearer <your_api_key>
Content-Type: application/json
X-Aevum-Env: <sandbox|production>

Quick Start

Fetch your first tracked bill in under 30 seconds:

cURL

curl -X GET \
  https://api.aevum.news/v1/bills \
  -H "Authorization: Bearer sk_live_aeX9k2..." \
  -H "X-Aevum-Env: sandbox" \
  -d '{
    "currency": "USD",
    "limit": 5
  }'

JavaScript (Fetch)

const response = await fetch(
  'https://api.aevum.news/v1/bills', {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    }
  }
);
const data = await response.json();

Python (requests)

import requests

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "X-Aevum-Env": "sandbox"
}
response = requests.get("https://api.aevum.news/v1/bills", headers=headers)
print(response.json())

Endpoints

GET /v1/bills

Retrieve a paginated list of tracked bills based on filters.

Parameter	Type	Description
`currency`	string	Filter by ISO 4217 currency code
`status`	string	Pending, Paid, Overdue, or All
`limit`	integer	Max results (default: 20, max: 100)
`offset`	integer	Pagination cursor

Response 200 OK

{
  "data": [
    {
      "id": "bill_8f3k9d2m",
      "vendor": "Global Logistics Corp",
      "amount": 1250.00,
      "currency": "USD",
      "due_date": "2025-08-15",
      "status": "pending",
      "tracked_at": "2025-06-10T14:22:00Z"
    }
  ],
  "meta": { "total": 142, "has_more": true }
}

POST /v1/bills/track

Parameter	Type	Required
`vendor_name`	string	Yes
`invoice_id`	string	Yes
`amount_due`	number	Yes
`due_date`	date (ISO 8601)	Yes
`webhook_url`	url	No

GET /v1/bills/:id/status

Fetch live status updates and payment history for a specific tracked bill.

DELETE /v1/bills/:id

Remove a bill from tracking. Does not affect vendor records.

Error Handling

The API uses standard HTTP status codes and returns structured error objects.

400

Bad Request. Invalid JSON or missing required fields.

401

Unauthorized. Missing or invalid Bearer token.

429

Rate Limit Exceeded. Wait before retrying.

404

Not Found. Bill ID does not exist in scope.

500

Internal Error. Contact support if persistent.

503

Service Unavailable. Scheduled maintenance.