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.

Returns official corporate filings sourced from the NGX Group document library, updated twice daily. Every disclosure includes a direct document_url link to the source PDF. Results are sorted newest first by default. Use GET /v1/disclosures/types to discover all valid values for the type filter.

​
Submission types

TypeDescription
Financial StatementsQuarterly and annual audited financial reports
Corporate ActionsMajor company announcements and corporate events
Board Meeting (BM)Board meeting notices, results, and resolutions
Annual General Meeting (AGM)AGM notices, results, and resolutions
Extra-Ordinary General Meeting (EGM)Emergency or special shareholder meetings
DirectorsDealingsInsider trading and director share transaction reports
EarningForcastEarnings guidance and forecast filings

​
Filtering by company

Use the symbol param to scope results to a single company. If you’re building a stock detail view, GET /v1/companies/{symbol}/disclosures is a cleaner alternative.

​
Example requests

curl "https://api.ngnmarket.com/v1/disclosures?symbol=GTCO&type=Financial+Statements" \
  -H "Authorization: Bearer ngm_live_YOUR_KEY"

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
string

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