GET /repositories/{id} — Get a Repository

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

import requests

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

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

{
  "id": 101,
  "name": "Emerging Markets Macro",
  "description": "GDP, inflation, and rates for EM economies",
  "privacy": "Private",
  "team": "research",
  "permission": "Owner"
}

{
  "message": "Repository 101 doesn't exist"
}

Use this endpoint to fetch the details of a specific repository by its numeric ID. The response includes your effective permission level for that repository, which determines what operations you can perform on it.

Request

GET https://api.alphacast.io/repositories/{repository_id}

Authentication

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

Path parameters

integer

required

The numeric ID of the repository to retrieve.

Response

Returns a single repository object on success.

integer

Unique numeric identifier for the repository.

string

Display name of the repository.

string

Optional description of the repository’s contents or purpose.

string

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

string

The team this repository belongs to, if applicable.

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.

Errors

Status	Meaning
`404`	No repository with the given ID exists, or you do not have access to it.

Example

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

import requests

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

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

{
  "id": 101,
  "name": "Emerging Markets Macro",
  "description": "GDP, inflation, and rates for EM economies",
  "privacy": "Private",
  "team": "research",
  "permission": "Owner"
}

{
  "message": "Repository 101 doesn't exist"
}

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

import requests

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

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

{
  "id": 101,
  "name": "Emerging Markets Macro",
  "description": "GDP, inflation, and rates for EM economies",
  "privacy": "Private",
  "team": "research",
  "permission": "Owner"
}

{
  "message": "Repository 101 doesn't exist"
}

Overview

Repositories

Datasets

Data Providers

GET /repositories/{id} — Get a Repository

Request

Authentication

Path parameters

Response

Errors

Example