API Documentation

Integrate with our platform using our REST API

Authentication

OAuth 2.0 & API Keys

Webhooks

Real-time events

Rate Limits

1000 requests/min

API Reference

Authentication

Generate an authentication token

POST

/api/v1/auth/token

curl -X POST https://api.gocity.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "your_client_id",
    "client_secret": "your_client_secret"
  }'

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Programs

List all training programs

GET

/api/v1/programs

curl https://api.gocity.com/v1/programs \
  -H "Authorization: Bearer your_access_token"

{
  "programs": [
    {
      "id": "prog_123",
      "name": "Full Stack Development",
      "duration": "12 months",
      "participants": 25
    }
  ],
  "total": 1,
  "page": 1
}

Teams

Retrieve team information

GET

/api/v1/teams

curl https://api.gocity.com/v1/teams \
  -H "Authorization: Bearer your_access_token"

{
  "teams": [
    {
      "id": "team_456",
      "name": "Cloud Infrastructure",
      "members": 5,
      "projects": 3
    }
  ],
  "total": 1,
  "page": 1
}