> This page is for Developers.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.emnify.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.emnify.com/_mcp/server.

> Organization API reference for managing hierarchical organization structures, contacts, and multi-tenancy relationships.

Organizations are hierarchically organized via parent/child relation with a relation type.

The API provides:

* CRUD operations via `POST`, `GET`, `PATCH` and `DELETE` actions
* services for managing organization hierarchy
* services for managing contacts
* access points for **lookup values**:
  * organization status
  * organization type
  * organization relation type
  * organization verification type
  * contact type

The following is a sample organization in its JSON representation:

```json maxLines=15
{
  "id": 12,
  "name": "Tele17",
  "ext_reference": "",
  "class":{
    "id": 0,
    "description": "Commercial"
  },
  "type": {
    "id": 1,
    "description": "Provider"
  },
  "country": {
    "id": 74,
    "name": "Germany",
    "mcc": "262",
    "country_code": "49",
    "isocode": "de"
  },
  "status": {
    "id": 1,
    "description": "Suspended"
  },
  "relation": {
    "id": 17,
    "type": {
      "id": 0,
      "description": "Customer of"
    }
  },
  "monthly_cost_limit": 1000,
  "currency": {
    "id": 1,
    "code": "EUR",
    "symbol": "€"
  },
  "created": "2015-02-03T00:00:00.000+0000",
  "verification_type": {
    "id": 1,
    "description": "Business registration number"
  },
  "verification": "123456789"
}
```

## Organization object

The organization object has the following properties:

| Name                 | Type      | Description                                                                                                                                                                                       |
| :------------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`                 | Integer   | Unique ID of this organization                                                                                                                                                                    |
| `name`               | String    | Name of organization                                                                                                                                                                              |
| `class`              | Object    | `id` (Integer)  - ID of the class of this organization  `description` (String) - Description of the class                                                                                         |
| `type`               | Object    | `id` (Integer) - ID of the type of this organization  `description` (String) - Description of meaning of the type                                                                                 |
| `country`            | Object    | `id` (Integer) - ID of the country of this organization  `name` (String) - Country name  `mcc` (String) - mobile country code  `country_code` (String) -  `isocode` (String) - ISO 3166-1 alpha-2 |
| `status`             | Object    | `id` (Integer) - ID of status this organization  `description` (String) - Description of meaning of the status                                                                                    |
| `relation`           | Object    | `id` (Integer) - ID of the relation  `type` (Object) type of the relation  `description` (String) - Description of meaning of the type id  `id` (integer) ID of the relation type                 |
| `ext_reference`      | String    | Additional information (for example, customer ID)                                                                                                                                                 |
| `monthly_cost_limit` | Integer   | Amount of spend money when the organization is blocked                                                                                                                                            |
| `currency`           | Object    | `id` (Integer) - ID of the currency  `code` (String) - Name of the currency  `symbol`(String) - Symbol of the currency                                                                            |
| `created`            | Timestamp | Timestamp when this organization was created - Type: ISO 8601 timestamp format                                                                                                                    |
| `verification_type`  | Object    | `id` (Integer) - ID of this verification type  `description` (String) - Description of the verification type                                                                                      |
| `verification`       | String    | verification data                                                                                                                                                                                 |