Stats

Stats about Companies Zone itself

New stats should be published roughly every 60 minutes. As the time required by the publishing service to collect stats can vary, you shouldn't poll more often than every 90 minutes if you're trying to keep a local database in sync.

Get Latest Stats

GET https://companies.zone/api/stats

200: OK

{
    // Time stats last published
    "date": "2023-10-14T15:49:10.369Z",
    "documents": {
        "count": 30386907,
        "pageCount": 134558837,
        "uniqueFilers": 6444946
    }
}

Get Stats As of a Certain Time

GET https://companies.zone/api/stats/{time}

Get the last published stats before a certain time (i.e. the latest stats that were published at the specified time)

Path Parameters

Name	Type	Description
time*	Instant	Time in Java Instant format (i.e. ISO-8601)

200: OK

{
    // Time stats last published
    "date": "2023-10-14T15:49:10.369Z",
    "documents": {
        "count": 30386907,
        "pageCount": 134558837,
        "uniqueFilers": 6444946
    }
}

400: Bad Request Invalid timestamp

{
    "code": 400,
    "error": "BAD_REQUEST",
    "message": "Unable to parse timestamp"
}