External Card API Documentation

This document describes the usage, authentication, endpoints, request formats, responses, and error handling for the Trick Ads Agency Ltd External Card API.

This API is intended for authorized users to securely fetch card data and transaction records associated with their active subscription plan.

1. Base URL

https://www.trickadsagencyltd.com/api/external

2. Authentication

All API requests must include a valid API key in the request header.

X-API-KEY: YOUR_API_KEY Accept: application/json

Important: Requests without a valid API key or without an active plan will be rejected.

3. API Endpoints

3.1 Fetch Cards

Endpoint:

POST /cards/fetch

Example Request:

curl -X POST https://www.trickadsagencyltd.com/api/external/cards/fetch \  -H "X-API-KEY: YOUR_API_KEY" \  -H "Accept: application/json"

Successful Response:

{  "status": "success",  "data": [    {      "card_id": "airw_123456789",      "card_type": "Virtual",      "status": "active",      "currency": "USD"    }  ] }

Error Response (No Active Plan):

{  "status": "error",  "message": "Active plan required" }

3.2 Fetch Card Transactions

Endpoint:

GET /cards/transactions

Query Parameters:

Example Request:

curl -X GET "https://www.trickadsagencyltd.com/api/external/cards/transactions?card_id=airw_123456789" \  -H "X-API-KEY: YOUR_API_KEY" \  -H "Accept: application/json"

Successful Response:

{  "status": "success",  "data": [    {      "transaction_id": "txn_987654321",      "amount": "25.00",      "currency": "USD",      "type": "debit",      "status": "completed",      "created_at": "2026-02-07 09:45:00"    }  ] }

Error Response:

{  "status": "error",  "message": "Active plan required" }

4. Error Codes

5. Plan Requirement

Access to card and transaction APIs requires an active subscription plan. If your plan is expired or inactive, the API will return an error message.

Please ensure your account has an active plan before making API requests.

6. Security Notice

• Never expose your API key publicly
• Rotate API keys periodically
• Use HTTPS for all requests

7. Support

If you experience any issues or need assistance with the API, please contact our support team:

Trick Ads Agency Ltd
Email: [email protected]

Last updated: February 2026