Skip to main content
GET
/
v1
/
disclosures
Corporate disclosures feed
curl --request GET \
  --url https://api.ngnmarket.com/v1/disclosures \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "data": [
      {
        "title": "Q1 2026 audited financial statements",
        "company_name": "MTN Nigeria Communications Plc",
        "company_symbol": "MTNN",
        "isin": "NGMTNN000002",
        "submission_type": "Financial Statements",
        "document_url": "https://doclib.ngxgroup.com/Financial_NewsDocs/46855_MTN_NIGERIA.pdf",
        "disclosed_at": "2026-04-29T19:15:03.000Z",
        "modified_at": "2026-04-29T19:15:03.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 25,
      "total": 1193,
      "pages": 48,
      "has_next": true,
      "has_prev": false
    }
  },
  "meta": {
    "plan": "free",
    "calls_used": 10,
    "calls_remaining": 9990,
    "reset_at": "2026-06-01T00:00:00.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ngnmarket.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Pass your API key as a Bearer token: Authorization: Bearer ngm_live_YOUR_KEY. Generate keys at ngnmarket.com/dashboard/developer.

Query Parameters

symbol
string

Filter by company ticker symbol (e.g. GTCO, DANGCEM). Case-insensitive.

Example:

"GTCO"

type
string

Filter by submission type. Use /v1/disclosures/types for valid values.

Example:

"Financial Statements"

Search by company name, ticker, or document title.

Example:

"Zenith Bank"

from
string<date>

Return disclosures on or after this date.

Example:

"2026-01-01"

to
string<date>

Return disclosures on or before this date.

Example:

"2026-12-31"

sort
enum<string>
default:disclosed_at

Field to sort by.

Available options:
disclosed_at,
modified_at,
company_name,
submission_type
order
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc
page
integer
default:1
Required range: x >= 1
limit
integer
default:25
Required range: 1 <= x <= 100

Response

Disclosures retrieved successfully.

success
boolean
required
meta
object

Quota and plan metadata included on every authenticated response.

data
object