GET /repositories — List All Repositories

Retrieve all repositories accessible to the authenticated user. Returns an array of repository objects with id, name, privacy, and permission fields.

The list repositories endpoint returns every repository your API key can access, including repositories you own and those shared with you by other team members. The permission field in each result tells you your effective access level for that repository.

Request

GET https://api.alphacast.io/repositories

No query parameters or request body are required.

Authentication

This endpoint requires HTTP Basic Auth. Pass your API key as the username and leave the password empty.

curl -u YOUR_API_KEY: https://api.alphacast.io/repositories

Response

The endpoint returns a JSON array. Each element is a repository object.

id · integer

Unique numeric identifier for the repository.

name · string

Display name of the repository.

description · string

Optional description of the repository’s contents or purpose.

privacy · string

Visibility setting. Either "Public" or "Private".

team · string

The team this repository belongs to, if applicable.

permission · string

Your access level for this repository. One of "Owner", "Admin", "Write", "Clone", or "Read". This field is determined by the server based on your API key and cannot be set directly.

Example

cURL

curl -u YOUR_API_KEY: \
  https://api.alphacast.io/repositories

import requests

response = requests.get(
    "https://api.alphacast.io/repositories",
    auth=("YOUR_API_KEY", ""),
)
repositories = response.json()

const response = await fetch("https://api.alphacast.io/repositories", {
  headers: { Authorization: "Basic " + btoa("YOUR_API_KEY:") },
});
const repositories = await response.json();

200

[
  {
    "id": 101,
    "name": "Emerging Markets Macro",
    "description": "GDP, inflation, and rates for EM economies",
    "privacy": "Private",
    "team": "research",
    "permission": "Owner"
  },
  {
    "id": 204,
    "name": "Global Equity Indices",
    "description": null,
    "privacy": "Public",
    "team": null,
    "permission": "Read"
  }
]