Skip to main content
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 -u YOUR_API_KEY: \
  https://api.alphacast.io/repositories

[
  {
    "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"
  }
]