neosourceDocs
Search docs

Get repository details

GET/api/repos/{owner}/{repo}

getRepository

Returns the repository metadata and projected view snapshot. Authentication is optional; anonymous callers can only resolve public repositories.

Authentication is not described for this operation in the spec — that does not mean it is public. Check tokens and scopes.

curl

curl -X GET 'https://neosource.dev/api/repos/OWNER/REPO'

fetch

fetch("https://neosource.dev/api/repos/OWNER/REPO", {
  method: "GET",
});

Path parameters

ownerrequired

Repository owner or organization slug.

string

reporequired

Repository name.

string

Responses

200Repository details

application/json

RepoDetailResponse

all of

  • RepoResponse

    object

    allowed_merge_methodsrequired

    array

    Which merge methods this repo permits at all. Never empty, and always in a canonical order (`merge` before `squash`) — it is a set, so the server normalises the order on write rather than echoing the order it was sent.

    itemsMergeMethod
    created_atrequired

    integerint64

    created_byrequired

    string

    default_branchrequired

    string

    default_merge_methodrequired
    MergeMethod
    delete_branch_on_mergerequired

    boolean

    Whether merging a PR against this repo also deletes its source branch. `true` on a repo nobody has configured — see the settings route for why this one defaults on where the merge-method fields default to today's behaviour.

    descriptionrequired

    string

    ownerrequired

    string

    parent
    one of
    repo_idrequired

    string

    slugrequired

    string

    statusrequired
    RepoStatusOutput
    updated_atrequired

    integerint64

    versionrequired

    integerint32

    visibilityrequired
    RepoVisibilityInput
    workspace_idrequired

    string

  • object

    issue_policyrequired

    RepoIssuePolicy

    object

    Lightweight issue policy carried by repository detail so ordinary issue pages do not have to probe provider-specific integration endpoints.

    can_createrequired

    boolean

    Whether the API accepts native repo-bound issue creation.

    import_in_progressrequired

    boolean

    Whether imported issue metadata is currently being backfilled. Consumers that need live counters may conditionally query the provider status endpoint while this is true.

    sourcerequired
    RepoIssueSource
    languages
    one of

    • null

    • RepoLanguages

      object

      The breakdown as it rides [`crate::repo::RepoDetailResponse`]. Deliberately narrower than [`RepoLanguagesResponse`]: no `ref`, no `tree_oid`. Those exist so a standalone endpoint can say *which* answer it returned; on the detail response the repo and its default branch are already named, and the tree OID is a staleness gate the client has no use for.

      languagesrequired

      array

      The [`MAX_LANGUAGES`] largest, `code` descending then `name` ascending.

      itemsRepoLanguageStat
      other_coderequired

      integerint64

      Total `code` across the languages folded out by the cap, 0 if none.

      other_languagesrequired

      integerint32

      How many were folded. 0 is the flag a client renders no bucket on.

      total_coderequired

      integerint64

      Denominator across EVERY language, folded tail included.

      truncatedrequired

      boolean

      `true` when the walk hit its byte-inflation cap (ADR 0105 §7): a partial but honest count, never silently complete.

    mirror
    one of

    • null

    • RepoMirrorSummary

      object

      Upstream this repo is mirrored to (push-only). Surfaced on the overview "About" panel so a repo connected to GitHub/GitLab advertises it. The URL is credential-stripped before it reaches the wire.

      kindrequired
      RepoMirrorKind
      urlrequired

      string

    statsrequired

    RepoStats

    object

    Whole-repo aggregate counts for the overview "About" panel. `star_count` is served count-on-read from the `repo_stars` join table; the commit/ contributor counts come from the commit-log projection.

    contributor_countrequired

    integerint64

    open_issue_countrequired

    integerint64

    Non-terminal issues on this repo (Issues tab badge).

    open_pr_countrequired

    integerint64

    Open pull requests on this repo (Pull requests tab badge).

    star_countrequired

    integerint64

    total_commitsrequired

    integerint64

    viewrequired

    ViewResponse

    object

    headsrequired

    array

    items

    string

    summaryrequired

    string

    versionrequired

    integerint64

    viewer_has_starredrequired

    boolean

    Whether the authenticated caller has starred this repo. Always `false` for anonymous callers.

Standard errors

Bodies documented once for the whole API — see standard errors.

  • 400Bad Request — one of: invalid_input
  • 403Forbidden — one of: forbidden
  • 404Not Found — one of: not_found
  • 423Locked — one of: busy
  • 429Rate limited — retry after the `Retry-After` header
  • 500Internal server error
  • 503Service temporarily unavailable / at capacity — retry after the `Retry-After` header
  • 504Gateway timeout — the request exceeded the server's handling budget

Schemas

Referenced above. Listed here rather than expanded inline, so the same definition is not repeated at every level.

MergeMethod

string

How a pull request's commits land on its target branch. A repo carries two settings over this enum (`migrations/20260820120000_repo_merge_methods.sql`): the set it *permits* (`RepoRecord::allowed_merge_methods`, never empty) and the one the merge path reaches for when the request names none (`RepoRecord::default_merge_method`, always a member of that set — enforced by the settings route, which is the only place both columns are visible at once). `Default` is [`MergeMethod::Merge`] to match the column default, which is itself the pre-existing behaviour of every repo: before this setting existed, a merge always minted a two-parent commit. `Rebase` is deliberately absent rather than merely unimplemented — it replays N commits, can conflict per commit, and rewrites the SHAs the stacked-PR re-parent invariant leans on (`plans/archive/pr-merge-methods-2026-08.md` §"Not doing"). Adding it later is one `ALTER TYPE merge_method ADD VALUE` plus an arm here, which is why the stored shape is an enum array and not a pair of booleans.

"merge""squash"

RepoParentInfo

object

Summary of a fork's parent repository.

repo_idrequired

string

RepoStatusOutput

string

Repo lifecycle state surfaced by the API. Mirrors `RepoStatus`. See ADR 0012 §2.

"creating""ready""importing""import_failed"

RepoVisibilityInput

string

"public""internal""private"

RepoIssueSource

string

Where repository issue content is sourced from.

"native""github"

RepoLanguageStat

object

One language's line counts across the default branch's tip tree.

blanksrequired

integerint64

Blank lines.

coderequired

integerint64

Lines that are neither blank nor a comment.

commentsrequired

integerint64

Comment lines.

filesrequired

integerint64

Files that classified as this language. Zero for a language that only appears embedded in another (JavaScript inside an HTML `<script>`) — its lines count, but the enclosing file is one file of its own kind.

namerequired

string

tokei's language name (`Rust`, `TypeScript`, `Cpp`, …). A deliberately **open vocabulary**, not a closed-set enum: tokei owns ~150 names upstream and adds to them, and mirroring that table is the alternative ADR 0105 §Rejected already rejected.

RepoMirrorKind

string

Mirror target host kind. Mirrors `MirrorTargetKind`.

"github""gitlab""generic"