filings_retrieve

Retrieve detailed information for a single filing by its ID.

Responses

🟢200OK

application/json

Body

Serializer for regulatory filings.

integer

read-onlyrequired

Unique identifier for the filing.

company

object

read-onlyrequired

Basic details of the company that made the filing.

integer

read-onlyrequired

Unique identifier for the company.

name

string

read-onlyrequired

Company name.

lei

string

read-onlyrequired

Legal Entity Identifier (ISO 17442).

sub_industry_code

string

read-onlyrequired

GICS Sub-Industry code classifying the company.

country_code

string

read-onlyrequired

ISO 3166-1 alpha-2 country code of the company's primary registration or headquarters.

filing_type

object

read-onlyrequired

Details of the filing type.

code

string

read-onlyrequired

Unique code identifying the filing type.

name

string

read-onlyrequired

Human-readable name of the filing type.

description

string

read-onlyrequired

Detailed description of the filing type.

language

object

read-onlyrequired

Language of the filing document.

code

string

read-onlyrequired

ISO 639-1 language code (lowercase).

name

string

read-onlyrequired

Name of the language.

filing_date

string <date>

read-onlyrequired

The official date the document was filed.

title

string

read-onlyrequired

Title of the filing document.

added_to_platform

string <date-time>

read-onlyrequired

Timestamp when the filing was added to our system (UTC).

updated_date

string <date-time>

read-onlyrequired

Timestamp when the filing record was last updated (UTC).

dissemination_datetime

string <date-time>

read-onlyrequired

Timestamp when the filing was disseminated by the source (UTC).

release_datetime

string <date-time>

read-onlyrequired

Timestamp when the filing was released (e.g., for press releases) (UTC).

source

object

read-onlyrequired

Source from which the filing was obtained.

name

string

read-onlyrequired

Name of the data source.

url

string <uri>

read-onlyrequired

URL of the data source homepage or relevant section.

description

string

read-onlyrequired

Description of the data source.

document

string <uri>

read-onlyrequired

URL link to the primary filing document (e.g., PDF, HTML).

processed_filing_id

integer | null

read-onlyrequired

ID of the processed version of this filing, if available. Null otherwise.

Example

{
  "id": 0,
  "company": {
    "id": 0,
    "name": "string",
    "lei": "string",
    "sub_industry_code": "string",
    "country_code": "string"
  },
  "filing_type": {
    "code": "string",
    "name": "string",
    "description": "string"
  },
  "language": {
    "code": "string",
    "name": "string"
  },
  "filing_date": "2019-08-24",
  "title": "string",
  "added_to_platform": "2019-08-24T14:15:22Z",
  "updated_date": "2019-08-24T14:15:22Z",
  "dissemination_datetime": "2019-08-24T14:15:22Z",
  "release_datetime": "2019-08-24T14:15:22Z",
  "source": {
    "name": "string",
    "url": "http://example.com",
    "description": "string"
  },
  "document": "http://example.com",
  "processed_filing_id": 0
}

🟠400Invalid input

🟠401Unauthorized: Invalid or missing API key

🟠403Forbidden: User does not have API access

Request

Request samples

Responses