# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gramhal.gitbook.io/matar/developer-reference/api/organization-selection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.