List Provider Accounts

API returns a list of linked eInvoice provider accounts in the system


API Endpoint

GET
https://einvoice-api-sandbox.sepay.vn/v1/provider-accounts

API Request

pageinteger

Current page (default 1)

Default: 1
per_pageinteger

Number of records per page (default 20)

Default: 20

API Response

Success Response (200)
{
  "data": {
    "paging": {
      "per_page": 20,
      "total": 1,
      "has_more": false,
      "current_page": 1,
      "page_count": 1
    },
    "items": [
      {
        "id": "0aea3134-da40-11f0-aef4-52c7e9b4f41b",
        "provider": "matbao",
        "active": true
      }
    ]
  }
}
dataobject

Error Handling

401Unauthorized

Missing or invalid Bearer token.

Notes

Note
  • Use id from the provider account list as the value for provider_account_id field when creating an eInvoice.
  • Supports pagination with page and per_page parameters (maximum 100 records per page).

Code Examples

>
>
>
curl --request GET \
--url 'https://einvoice-api-sandbox.sepay.vn/v1/provider-accounts?page=1&per_page=20' \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Next Steps

After getting the list of provider accounts, you can:

  1. View Account Details - Get detailed information (invoice templates, series) for a specific account
  2. Create eInvoice - Use the account id to create an invoice with provider_account_id