> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.mysoleas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Read the primary country

> Return the primary operating country for the current tenant.

This route returns the `TenantCountry` relation marked as primary for the tenant of the current token.

The primary country is used as the default context when some flows need to calculate fees or route a payment without a reliable explicit country.

If no primary country is configured on an older account, the response can contain `data: null`. In that case, existing flows keep their historical fallback.

```json theme={null}
{
  "id": 42,
  "is_primary": true,
  "tenant": "tenant_123",
  "Country": "CMR",
  "updated_at": "2026-08-08 12:30:00"
}
```


## OpenAPI

````yaml en/api-reference/openapi.json GET /country/primary
openapi: 3.1.0
info:
  title: Mysoleas API
  version: 3.0.0
  description: >-
    New Mysoleas architecture: business gateway, Mysoleas Identity Cloud, and
    SoleasPay ecosystem.
servers:
  - url: https://api.mysoleas.com
    description: Mysoleas gateway
  - url: https://account.mysoleas.com
    description: Mysoleas authentication
security:
  - spAuthToken: []
tags:
  - name: Identity Cloud
  - name: Plugin
  - name: Payment links
  - name: Subscriptions
  - name: Collections
  - name: Disbursements
  - name: Verification
  - name: Catalog
paths:
  /country/primary:
    get:
      tags:
        - Catalog
      summary: Read the primary operating country
      description: >-
        Returns the primary TenantCountry for the current tenant. If no primary
        country is configured, data is null and older flows keep the historical
        fallback.
      responses:
        '200':
          description: Pays primaire ou null
        '401':
          description: Unauthenticated
        '404':
          description: Tenant introuvable
      security:
        - spAuthToken: []
components:
  securitySchemes:
    spAuthToken:
      type: apiKey
      in: header
      name: x-sp-auth-token
      description: >-
        JWT Bearer emis par Mysoleas Identity Cloud. Format: Bearer
        <access_token>.

````