> ## Documentation Index > Fetch the complete documentation index at: https://help.doozy.live/llms.txt > Use this file to discover all available pages before exploring further. # Get a cohort > Retrieve one cohort the authenticated user can see. ## OpenAPI ````yaml /openapi.json get /v1/cohorts/{cohort_id} openapi: 3.0.3 info: title: Doozy Public API version: 1.0.0 description: >- The Doozy Public API allows you to programmatically access your organization's data. ## Authentication All API requests require an API key passed in the `x-api-key` header. ``` x-api-key: dzy_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ``` API keys can be generated and managed through the Doozy dashboard. Each key is associated with a user account and inherits that user's permissions. ## Rate Limiting API requests are rate limited. Rate limiting is handled by Cloudflare. If you exceed the rate limit, you'll receive a 429 Too Many Requests response. ## Pagination List endpoints support cursor-based pagination using `limit` and `starting_after` query parameters. contact: name: Doozy Support email: support@doozy.live url: https://help.doozy.live/api servers: - url: https://api.doozy.live description: Production security: - apiKey: [] tags: - name: Quizzes description: Quiz analytics and reporting endpoints - name: Tracks description: Track management and analytics endpoints - name: Surveys description: Survey and poll analytics endpoints - name: Introductions description: Doozy Roulette and Matchmaking introduction endpoints - name: Account description: 'Owner-only workspace settings: user provisioning and feature permissions' paths: /v1/cohorts/{cohort_id}: get: tags: - Cohorts summary: Get a cohort description: Retrieve one cohort the authenticated user can see. parameters: - schema: type: string minLength: 1 maxLength: 128 pattern: ^[A-Za-z0-9_-]+$ example: a7Aj3iEr4vqL6XAN0h2n required: true name: cohort_id in: path responses: '200': description: The cohort content: application/json: schema: $ref: '#/components/schemas/Cohort' '401': description: Authentication required - missing API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Cohort not found or user does not have access content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - apiKey: [] components: schemas: Cohort: type: object properties: object: type: string enum: - cohort id: type: string name: type: string program_id: type: string nullable: true description: The program this cohort belongs to status: type: string enum: - upcoming - active - completed - archived - skipped example: upcoming start_date: type: string format: date-time description: When the cohort starts (ISO 8601 datetime) end_date: type: string format: date-time description: When the cohort ends, exclusive (ISO 8601 datetime) timezone: type: string nullable: true member_count: type: integer channel: type: object nullable: true properties: object: type: string enum: - slack_channel id: type: string name: type: string required: - object - id - name description: The cohort's Slack channel, once it has one required: - object - id - name - program_id - status - start_date - end_date - timezone - member_count - channel ErrorResponse: type: object properties: error: type: object properties: type: type: string enum: - api_error - authentication_error - invalid_request_error - rate_limit_error - not_found_error - permission_error description: The type of error returned example: invalid_request_error code: type: string nullable: true enum: - api_key_required - api_key_invalid - firebase_id_token_required - firebase_id_token_invalid - appcheck_token_required - appcheck_token_invalid - account_id_required - account_id_invalid - api_access_disabled - api_access_unauthorized - api_access_role_not_allowed - parameter_missing - parameter_invalid - resource_already_exists - resource_in_use - resource_not_found - permission_denied - not_implemented - internal_error - rate_limit_exceeded - upstream_error - user_not_found - user_not_connected_to_slack - user_missing_roles_for_track - user_already_on_track - user_already_completed_track - enrollee_already_terminal - track_not_active - track_not_enrollable - action_forbidden - api_access_plan_not_supported - plan_not_supported - draft_stale - invalid_cursor - program_archived - program_not_active - program_track_not_live - invalid_status_transition - mentorship_not_proposed - mentorship_ended - approval_waiting_on_mentor - no_reachable_manager - application_already_decided - participant_not_in_program - participant_already_answered - participant_not_mentor - reminder_pending - mentee_not_waiting - mentor_not_active - mentor_full - mentor_at_total - mentor_unchanged - same_person - invite_expired - invite_revoked - null description: Machine-readable error code for specific error conditions example: resource_not_found message: type: string description: Human-readable error message example: 'No such quiz: tYYueINbgmmyss8O3LiD' param: type: string nullable: true description: The parameter related to the error, if applicable example: id doc_url: type: string format: uri description: URL to documentation about this error example: https://docs.doozy.live/api/errors#resource_not_found request_id: type: string description: ID of the request, for support example: req_8KSh4mNxQ1aZbPoLcVrT required: - type - code - message - request_id required: - error securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: API key for authentication. Generate keys in the Doozy dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.