> For the complete documentation index, see [llms.txt](https://gramhal.gitbook.io/matar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gramhal.gitbook.io/matar/developer-reference/api/organization-selection.md).

# Organization Selection

{% hint style="info" %}
Organizations are communities that join Matar for seamless P2P audio conversations. Get a list of all organizations via the Get All Organizations API Endpoint.
{% endhint %}

## Get the list of organizations by Organization ID

<img src="/files/Suj5MC9PIAe5JjBzPhjV" alt="API: - https://matar.in.ngrok.io/api/v1/organizations" class="gitbook-drawing">

### Params

**Body Parameter ⬇️**

<table data-full-width="false"><thead><tr><th width="229.33333333333331">Header Parameter</th><th width="129">Data Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>Bearer {{access_token}} </strong><mark style="color:red;"><strong>(required)</strong></mark></td><td>String</td><td>Access token helps in secure access to Matar organization resources.</td></tr></tbody></table>

***

**Sample Request ⬇️️ (Body Parameter)**

```
curl --location 'https://matar.in.ngrok.io/api/v1/organizations' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmcmVzaCI6dHJ1ZSwiaWF0IjoxNjkyODcyNDIxLCJqdGkiOiIyZmNiODJiYi0zMDYzLTQzNGUtOGM5OS00NTVjMDhhY2Y3MmMiLCJ0eXBlIjoiYWNjZXNzIiwic3ViIjoiMzk1MDFUIiwibmJmIjoxNjkyODcyNDIxLCJleHAiOjE2OTM3MzY0MjF9.ovz0ItiPsYG_rqT3vEYl42WZBonX52NXf-oWE4DuGmQ'
```

**Responses ⬇️**

Status Code: **🟢200** (200 denotes **'ok'**)

```200
{
    "organizations": [
        {
            "_id": "129487316",
            "code": "https://matar.app.link/None",
            "description": null,
            "is_active": true,
            "is_chatgpt_enabled": null,
            "language": "hi-IN",
            "max_post_duration": 15,
            "org_type": 0,
            "title": "matar"
        },
        {
            "_id": "685QVK",
            "code": "https://matar.app.link/None",
            "description": null,
            "is_active": true,
            "is_chatgpt_enabled": null,
            "language": "kn-IN",
            "max_post_duration": 15,
            "org_type": 0,
            "title": "Tisser - DFLT Kannada"
        },
        {
            "_id": "XYBT7P",
            "code": "https://matar.app.link/None",
            "description": null,
            "is_active": true,
            "is_chatgpt_enabled": null,
            "language": "hi-IN",
            "max_post_duration": 15,
            "org_type": 0,
            "title": "Tisser - Indian Artisans"
        },
        {
            "_id": "K7QUEV",
            "code": "https://matar.app.link/None",
            "description": null,
            "is_active": true,
            "is_chatgpt_enabled": null,
            "language": "ur-IN",
            "max_post_duration": 15,
            "org_type": 0,
            "title": "Tisser - DFLT Telugu"
        }
    ]
}
```

Status Code: 🔴**404** (404 denotes **'Not found'**)

```
{
      "message": "Ain't no cake like that."
}
```

***

**Response Parameters Description:**

<table><thead><tr><th width="267">Response Parameter</th><th>Description</th></tr></thead><tbody><tr><td>_id</td><td>Organization ID</td></tr><tr><td>code</td><td>Organization Invite Link</td></tr><tr><td>description</td><td>Organization Description</td></tr><tr><td>is_active</td><td>Denotes organization active status. Two values: True or False</td></tr><tr><td>is_chatgpt_enabled</td><td>Is ChatGPT enabled to answer questions posted in the organization.</td></tr><tr><td>language</td><td>Language of the Organization.</td></tr><tr><td>max_post_duration</td><td>Total number of posts/questions that can be posted in the organization.</td></tr><tr><td>org_type</td><td>Organization Type. Three types of organizations are available. 0 denotes an open organization that anyone can join. 1 is a closed organization that requires an access code. 2 is an invite-only organization that can only be joined by an invite link.</td></tr><tr><td>title</td><td>Organization Title.</td></tr></tbody></table>