---
title: "List Namespaces"
method: GET
path: "/v2/functions/namespaces"
tags: ["DigitalOcean-public.v2-new_Functions"]
---

# List Namespaces

`GET /v2/functions/namespaces`

Returns a list of namespaces associated with the current user. To get all namespaces, send a GET request to `/v2/functions/namespaces`.

## Response `200`

An array of JSON objects with a key called `namespaces`.  Each object represents a namespace and contains
the properties associated with it.

- object
  - `namespaces` NamespaceInfo[]
    - `api_host` string — The namespace's API hostname. Each function in a namespace is provided an endpoint at the namespace's hostname.
    - `namespace` string — A unique string format of UUID with a prefix fn-.
    - `created_at` string — UTC time string.
    - `updated_at` string — UTC time string.
    - `label` string — The namespace's unique name.
    - `region` string — The namespace's datacenter region.
    - `uuid` string — The namespace's Universally Unique Identifier.
    - `key` string — A random alpha numeric string. This key is used in conjunction with the namespace's UUID to authenticate a user to use the namespace via `doctl`, DigitalOcean's official CLI.

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

---

[API](https://skmtc.net/digitalocean/apis/digitalocean-api.md) · [All operations](https://skmtc.net/digitalocean/apis/digitalocean-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalocean/digitalocean-api/versions/cb3bf9b21459/schema)