# Thai company figures

> Four figures for Thai listed companies, read from each company's own investor-relations website. Not from SET or the SEC.

```text
GET /v1/th/companies/{id}
GET /v1/th/companies/{id}/financials?field=net_income
```

Company-published financial statements read by Belfort Research from each company's own investor-relations website. Not from SET or the SEC. Every figure links to the company's file.

This is a small first release. It is separate from the SEC data on the rest of this site, and it follows its own rules.

```bash
curl -H "X-API-Key: $BELFORT_API_KEY" \
  "https://api.belfortagent.xyz/v1/th/companies/SPI/financials?field=net_income&period=quarterly"
```

## Which company

`{id}` is a SET symbol in any case, such as `GULF`, or a thirteen-digit company registration number. A US ticker or a CIK is not a Thai company id, and an unknown id is a 404 that costs nothing.

## Company

`GET /v1/th/companies/{id}` returns the name, the website, the page the statements are read from, the investor-relations platform that page runs on, the figures served for the company (`fields`), and the earliest and latest period end on file (`periods`).

## Figures

`GET /v1/th/companies/{id}/financials` returns one figure per call, newest period first.

| Parameter | Values | Default |
|---|---|---|
| `field` | `basic_eps`, `diluted_eps`, `net_income` or `cash_and_equivalents`. Required. | |
| `period` | `quarterly` (Q1 to Q3), `annual` (the full year) or `all`. | `all` |
| `limit` | Points per page, one to one hundred. | forty |
| `cursor` | The previous page's `meta.next_cursor`, with the same filters. | |

| Field | Meaning | Unit |
|---|---|---|
| `basic_eps` | Basic earnings per share, as printed. | baht per share |
| `diluted_eps` | Diluted earnings per share. Served only where the statement prints a diluted line; most Thai companies print basic EPS only. | baht per share |
| `net_income` | Profit attributable to the owners of the parent, not the whole group. | baht |
| `cash_and_equivalents` | Cash and cash equivalents on the period end. | baht |

Each point has `fiscal_year`, `period` (`Q1`, `Q2`, `Q3` or `FY`), `period_end`, `duration`, `value`, `audit_status` and `source`.

- `duration` is `3M` for a discrete quarter, `12M` for a full year and `instant` for a balance on the period end. A year-to-date figure is never served as a quarter. When a quarter can't be told apart from a year-to-date figure, it is left out.
- `value` is exact decimal text in baht, already multiplied by the scale the company declared in its file. It is text so that no digit is rounded.
- `audit_status` is `reviewed`, `audited` or `unknown`, as the company's own file says.
- For companies whose year does not end in December, `fiscal_year` follows the company's own labelling, and `period_end` is always the real date.

## Where each figure comes from

`source` names the company's own file, the page that lists it, the company that published it, the day it was posted when the page shows it, when we retrieved it, a hash of the file as retrieved, and where in the file the figure sits (the sheet, the row and the line's label). Open `source.file_url` to check any figure against what the company published.

## Known limits

- **A small set of companies.** 24 Thai listed companies in this first release. A company whose site asks crawlers not to read its files is not here, and we do not work around that.
- **Four figures, group level, and the newest quarters.** Only consolidated (group) figures are served; a figure that cannot be proven to be the group's is left out. How much history there is differs by company.
- **Spreadsheet figures** are served at the precision the cell shows. If that precision cannot be established the figure is left out.
- **Loaded by hand.** There is no schedule yet. `GET /v1/status` shows how old the Thai load is, as `th_financials`.
- **A figure we can't read with confidence is left out**, not guessed. A missing quarter means we could not read it safely, not that the company did not report it.
- **No restatement history.** A later file for the same period replaces the earlier one.

## Taking a company out

The files are read by a named crawler. How it behaves, and how a company asks for removal, is on the [crawler page](/crawler/).

## Price

A call that returns at least one record costs the same as the matching SEC figure call. An error, an unknown company or an empty result is free. See [Pricing](/pricing/).

---
Source: https://docs.belfortagent.xyz/datasets/th-financials/
