# Get Filings by Symbol

`GET` `/v1/quote/filings`

> **Quote Permission Required · Free**
> Included with OpenAPI activation — no extra purchase needed.
> _OpenAPI quote perms are separate from App/Web perms_

Get the list of regulatory filings or disclosure documents for the specified symbol.
Each filing includes a title, file name, download URLs, and publication timestamp.

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | Security symbol to query filings for (e.g. `AAPL.US`, `700.HK`). |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/quote/filings?symbol=<symbol>' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `items` | object[] | No | Filings for the security. |
| `└ id` | string | No | Filing ID. |
| `└ title` | string | No | Filing title. |
| `└ file_name` | string | No | File name. |
| `└ file_urls` | array | No | Source document URLs. |
| `└ publish_at` | string | No | Publish time (Unix timestamp). |
| `└ description` | string | No | Filing description. |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "id": "627391979864985729",
        "title": "Apple | 4 - Apple Inc. (0000320193) (Issuer)",
        "description": "",
        "file_name": "4 - Apple Inc. (0000320193) (Issuer)",
        "file_urls": [
          "https://www.sec.gov/Archives/edgar/data/320193/.../wk-form4_1773786674.xml"
        ],
        "publish_at": "1773786677"
      }
    ]
  }
}
```
