Skip to main content
These are the fields for each endpoint in the API overview. You don’t need them to use Copilot through your agent. Fields are written in a short schema notation, not as sample responses:
  • [optional] means the field can be left out. null is a separate value from a missing field.
  • [default x] is the value used when the field is left out.
  • int means a whole number. Bounds on arrays count items; bounds on strings count characters.
  • Dates are ISO 8601 strings. Request objects marked [strict] reject unknown fields.
  • v2CategoryKey is one of the 41 category keys from GET /categories.

Your own data

arenaProfile

The signed-in profile and Arena-visible teammate profiles use these fields:
A teammate without a visible Arena profile has only displayName and username. No teammate email is returned.

meResponse

Returned by GET /me for the signed-in person. submission can contain draft and private fields.
prize is non-null only after the results are published. The response returns at most 200 projects and 2,000 updates across them; truncated marks either cap. It does not include judging scores, reviews or application status.

Projects

searchProjectsRequest

trackKeys and labelKeys cannot be combined. tracks lists the prize tracks a project entered, not the one it won; the winning track is prize.trackName. labels contains submission choices for events without track prizes. ambiguous returns neither until classification is resolved. filters.categoryKeys matches any listed key. filters.includeSecondaryCategories: true also matches a project’s second category; category counts can then overlap. filters.winnersOnly excludes honorable mentions. diversify spreads results across hackathons and tracks.

searchProjectsResponse

With an empty query, totalFound is the exact number of matching projects. With a text query, it only supports paging. categoryCountsOverlap is true when category counts include second categories.

projectSearchResult

evidence holds up to two matching snippets. builtWith lists up to 10 tool names per kind; fetch project details for the full record. award: "honorable_mention" identifies honorable mentions. They carry prize.type: "HONORABLE_MENTION" with no amount, and they’re recognitions, not wins. prize.trackName is the track a project won. Frontier had no tracks: its 25 TRACK_PRIZE awards named Winner are its top-25 awards, not track prizes.

searchDiagnostics

Returned when includeDiagnostics is true.
modeUsed says how results were ranked. "vector" scores by similarity (higher is closer), "hybrid" combines similarity, text and tags, "text" uses a fixed score, and "filters" (an empty query) scores 0 and lists newest first. Compare scores only within the same mode.

getProjectBySlugParams

projectDetails

isWinner is false for honorable mentions. categories.confidence says how clearly the project fits its main category, not how good it is. categories: null means the project hasn’t been categorized yet.

projectEvidence

Summaries of what the team submitted: its code, pitch and demo. A missing summary means Copilot has none, not that the team submitted nothing.

projectEvidenceSummary

text keeps Markdown up to 12,000 characters; truncated is true only when that limit cuts it off. sourceUrl links the public repository, presentation or demo, or is null when no valid link is known. The linked page may have changed since capture. sourceCapturedAt is when the source was captured; capturedAt is the same value under an older name. generatedAt is when the summary was written, and indexedAt is when Copilot last took it in. None of these dates show whether the project is still active. sourceInferred is true when the source was matched by type rather than declared by the team.

projectFreshness

Tools found in a project’s code

builtWith lists the tools found in a project’s public code when it was captured. It doesn’t show that the project still runs, or how the tools are used. builtWith: null means no record is available. An empty list for one kind means none was found, not that none was used. Project details return up to 100 tools per kind. Each has a display name, a confidence from 0 to 1, and an evidence quote of up to 120 characters. A version appears only when the source states one. Projects whose code isn’t public return names only, without confidence or evidence.

repositoryTags

repositoryTag

repositoryChainTag

Includes the repositoryTag fields and:

compactBuiltWith

The shorter form used in search results.

builtWithFilters

Names match exactly, ignoring case and surrounding spaces, with no aliases. Kinds combine with AND; names within one kind combine with OR. For example, this finds Cypherpunk projects tagged with Solana and either Kamino Lend or Jupiter:
These filters are separate from the older techStack tags.

filtersResponse

Analysis

analyzeRequest

Category buckets count main categories unless cohort.includeSecondaryCategories is true. For every category bucket at once, use dimensions: ["categories"] with topK: 43.

analyzeResponse

totals.winners excludes honorable mentions.

cohortDefinition

Used by POST /compare.

compareRequest

compareResponse

totalsA.winners and totalsB.winners exclude honorable mentions.

Technologies

Technology requests

Counts and trends take technology and cohort. Co-usage adds topK. Top takes cohort, technologyCategory and topK.
projects is the number of projects in the cohort, projectsWithRepositoryTags how many have recorded tools, and count how many are tagged with the technology. share is count / projects. Hackathons are in date order. Names come back in lowercase.

Technologies used together

In each result, count is the number of projects tagged with both technologies, and share is that count divided by the number tagged with the requested one. cohortCount is how many projects in the cohort are tagged with the other technology. lift is share / (cohortCount / projects): above 1 means the two appear together more often than the other technology appears overall. Results are ordered by count.

Top technologies

Results are ordered by count. Several hackathons in one cohort are combined; request each separately to rank them separately.

Research library

searchArchivesRequest

searchArchivesResponse

archiveSearchResult

getArchiveDocumentParams

archiveDocumentPageQuery

archiveDocumentPage

For excerpt-only sources, isExcerpt and restricted are true, and totalChars, nextOffset and hasMore describe only the excerpt.

Tools and FAQs

eventDates

V2 resources, FAQ lists and FAQ details include eventDates. Resources carry the dates of the requested hackathon. FAQ responses carry the dates of the most recently started hackathon, and null when the response has no hackathon FAQ (for example program=accelerator). winnerAnnouncementDate is null until Colosseum records it. Check the event’s page before giving timing advice.

resourcesResponse

Returned by GET /resources.
query.matched counts the sponsors, topic links and RPC providers returned. topicGroups lists only returned topics. A hackathon with a single track returns tracks: [].

faqsResponse

Returned by GET /faqs. GET /faqs/:program/:id returns { eventDates, source, faq }.

Account and feedback

statusResponse

scope is a space-separated list of granted scopes. expiresAt and scope can be null when unknown.

sourceSuggestionRequest

feedbackRequest