# Company List API

- Anchor: `bankhub-en-api-cong-ty-danh-sach-cong-ty`
- URL: https://developer.sepay.vn/en/bankhub/api/cong-ty/danh-sach-cong-ty.md
- Description: API to retrieve the list of companies created on the Bank Hub system. Supports pagination and filtering by status.

**GET** `https://bankhub-api-sandbox.sepay.vn/v1/company`
```http
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
```



**Query Parameters**

<!-- Params table -->

**Headers**

<!-- Params table -->

> **Note** (info)
>
>
> * This API requires a Bearer Token in the Authorization header
> * Results are sorted by newest creation time by default
> * The `active` field indicates whether the company is active (1 = Active, 0 = Pending)
>






**RESPONSE 200**


```json
{
  "data": [
    {
      "xid": "d3dafd01-e06b-11f0-b29e-52c7e9b4f41b",
      "full_name": "Pham Van Chien",
      "status": "Active",
      "active": "1",
      "created_at": "2025-12-24 08:56:55",
      "updated_at": "2026-01-04 14:56:46"
    }
  ],
  "meta": {
    "per_page": 20,
    "total": 1,
    "has_more": false,
    "current_page": 1,
    "page_count": 1
  }
}
```








---

### Usage Examples









> **Performance Notes** (warn)
>
>
> * Use an appropriate `per_page` value to optimize performance
> * Avoid requesting too many companies in a single request
> * Use `has_more` to check for remaining data instead of relying on `page_count`
>

---