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

# Quickstart

> Make your first successful call to the malibou public API.

Get your first successful call working in a few minutes: create an API key,
call an endpoint, then page through the results.

<Steps>
  <Step title="Create an API key">
    In the malibou app, go to [**Profile button → My company → API
    keys**](https://app.malibou.com/admin/company/api-keys), click **Create
    an API key**, and tick the `org:employee:read` permission. Copy the
    secret shown (you won't be able to view it again). See
    [Authentication](/authentication) for the full list of scopes and how to
    manage keys.
  </Step>

  <Step title="Retrieve your organization id">
    Open the [API keys page](https://app.malibou.com/admin/company/api-keys), open
    the actions menu (next to **Create an API key**) and choose **Copy
    organisation ID**. See
    [Authentication](/authentication#retrieve-your-organization-id) for details.
  </Step>

  <Step title="Make your first request">
    Call the collaborators endpoint with your key as a Bearer token:

    ```bash theme={null}
    curl "https://app.malibou.com/api/public/v1/organizations/{organizationId}/collaborators" \
      -H "Authorization: Bearer $API_KEY"
    ```
  </Step>

  <Step title="Paginate through the results">
    List endpoints return results in pages. Add `page` and `limit` to control
    how many results come back:

    ```bash theme={null}
    curl "https://app.malibou.com/api/public/v1/organizations/{organizationId}/collaborators?page=1&limit=50" \
      -H "Authorization: Bearer $API_KEY"
    ```

    Iterate by incrementing `page` until a page returns fewer items than
    `limit`. See [Pagination](/usage/pagination) for details.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Scopes, key management and the full authentication guide.
  </Card>

  <Card title="API reference" icon="terminal" href="/api-reference">
    Browse every endpoint, its parameters and responses.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/usage/errors">
    How the API reports errors.
  </Card>

  <Card title="Rate limits" icon="gauge" href="/usage/rate-limits">
    Stay within the request limits.
  </Card>
</CardGroup>