Get Endpoints Usage

GET

/v1/usage

Access usage statistics for various API endpoints for monitoring and auditing purposes.
Returns usage data for all endpoints accessible by the requesting account within the specified date range.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Responses

🟢200OK

application/json

Success

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error

🔴504Gateway Timeout

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.leadfeeder.com/v1/usage?account_id=123456&start_period=2025-01&end_period=2026-01' \
--header 'X-Api-Key: <api-key>'

Response Example

200 - Success Example

{
    "data": [
        {
            "type": "api_usage",
            "id": "2025-01_companies/search_POST",
            "attributes": {
                "period": "2025-01",
                "endpoint_path": "/companies/search",
                "http_method": "POST",
                "num_requests": 10,
                "num_failed_requests": 1,
                "num_successful_requests": 5,
                "num_returned_entities": 100
            }
        },
        {
            "type": "api_usage",
            "id": "2025-03_companies_GET",
            "attributes": {
                "period": "2025-03",
                "endpoint_path": "/companies",
                "http_method": "GET",
                "num_requests": 25,
                "num_failed_requests": 1,
                "num_successful_requests": 24,
                "num_returned_entities": 48
            }
        }
    ],
    "meta": {
        "total_records": 2,
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

Modified at 2026-04-14 13:35:01

Delete Custom Field

List of NACE / WZ codes