The submitters endpoint lacked pagination, making it inefficient for clients to retrieve large datasets. This adds limit and skip query parameters and wraps the response in an object with total count.

Changes

Handler (cmd/stats/main.go)

• Parse limit and skip using existing util.ParseLimitSkipShuffle (default: 10, max: 100)
• Apply pagination after filtering nil submitters
• Returns response wrapped in object with total count and results array
• limit=0 returns all results
• Endpoint registered at /v2/submitters (organized with submission-related endpoints)

SubmittersResult Structure (shared/people.go)

• Added SubmittersResult with Total (int) and Results ([]Submitter)
• Analogous to SearchResult used by programs and sequences endpoints

Tests (cmd/stats/submitters_test.go)

• 8 test cases covering default limit, custom pagination, edge cases
• All tests updated to expect new response structure with total and results
• Dynamic expected counts for maintainability

API Spec (openapi.v2.yaml)

• Added "Submissions" tag for program submission related endpoints
• Added SubmittersResult schema definition
• Endpoint at /submitters uses Submissions tag
• Updated Limit component: minimum: 0 to allow unlimited results

Test Script (test.sh)

• Updated to use new endpoint path

Response Format

{
  "total": 100,
  "results": [
    { "name": "submitter1", "numPrograms": 50 },
    { "name": "submitter2", "numPrograms": 30 }
  ]
}

Usage

# Default: first 10 submitters
GET /v2/submitters

# Custom pagination
GET /v2/submitters?limit=5&skip=10

# No limit
GET /v2/submitters?limit=0

Follows the same response pattern as /sequences/search and /programs/search for consistency.

• Fixes Add pagination to /stats/submitters endpoint #24

• Fixes Add pagination to /stats/submitters endpoint #24

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.