{ "openapi": "3.0.3", "info": { "title": "Sarkari Adda 24x7 Public & Recruitment Intelligence API", "version": "1.0.0", "description": "Official machine-readable OpenAPI 3.0.3 specification for SarkariAdda24x7.com. Provides real-time programmatic access to verified Indian government recruitment notifications, hall tickets (admit cards), exam results, answer keys, official syllabi, welfare schemes (Sarkari Yojana), and scholarships across Central and State government organizations.", "contact": { "name": "Sarkari Adda 24x7 Developer & Agent Support", "url": "https://sarkariadda24x7.com/developers", "email": "support@sarkariadda24x7.com" }, "license": { "name": "Open Data Commons Attribution License (ODC-By)", "url": "https://opendatacommons.org/licenses/by/1.0/" } }, "x-deprecation-policy": { "title": "Sarkari Adda 24x7 API Lifecycle and Sunset Policy", "description": "All public endpoints follow semantic versioning. Major breaking changes require a minimum 180-day deprecation period signaled via standard HTTP Sunset and Deprecation headers.", "policyUrl": "https://sarkariadda24x7.com/developers#deprecation-policy", "deprecationHeader": "Deprecation (RFC 9745)", "sunsetHeader": "Sunset (RFC 8594)" }, "servers": [ { "url": "https://sarkariadda24x7.com/api/v1", "description": "Production API v1 Endpoint (Canonical)" }, { "url": "https://sarkariadda24x7.com/api", "description": "Production Root API Endpoint" } ], "paths": { "/health": { "get": { "operationId": "getHealthStatus", "summary": "Check API and Database Health", "description": "Returns operational health, database connectivity status, and system timestamp of the Sarkari Adda API cluster.", "tags": [ "System" ], "responses": { "200": { "description": "API is healthy and operational", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthStatus" } } } }, "500": { "description": "Internal server or database error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } } } } }, "/jobs": { "get": { "operationId": "listGovernmentJobs", "summary": "List Verified Government Jobs", "description": "Returns active government vacancies across central ministries, state commissions, defence, banking, and police forces with cursor or page pagination and category filtering.", "tags": [ "Jobs" ], "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque cursor token for agent-friendly cursor-based streaming pagination", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Maximum items per page (default 20, max 100)", "schema": { "type": "integer", "default": 20 } }, { "name": "page", "in": "query", "description": "Page index for offset pagination (default 1)", "schema": { "type": "integer", "default": 1 } }, { "name": "category", "in": "query", "description": "Job category (e.g. SSC, Railway, UPSC, Banking, Police, Teaching)", "schema": { "type": "string" } }, { "name": "state", "in": "query", "description": "State filter or All India", "schema": { "type": "string" } }, { "name": "qualification", "in": "query", "description": "Minimum education qualification", "schema": { "type": "string" } }, { "name": "search", "in": "query", "description": "Keyword search query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Paginated list of government vacancies", "content": { "application/json": { "schema": { "type": "object", "required": [ "success", "data", "pagination" ], "properties": { "success": { "type": "boolean", "example": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/JobItem" } }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" } } } } } }, "400": { "description": "Invalid query parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } } } } }, "/admit-cards": { "get": { "operationId": "listAdmitCards", "summary": "List Recruitment Hall Tickets & Exam City Slips", "description": "Fetch released hall tickets, exam city intimation slips, and direct regional download links.", "tags": [ "Admit Cards" ], "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque cursor token for agent-friendly cursor-based streaming pagination", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Maximum items per page (default 20, max 100)", "schema": { "type": "integer", "default": 20 } }, { "name": "page", "in": "query", "description": "Page index for offset pagination (default 1)", "schema": { "type": "integer", "default": 1 } }, { "name": "search", "in": "query", "description": "Search query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Admit cards list with pagination", "content": { "application/json": { "schema": { "type": "object", "required": [ "success", "data", "pagination" ], "properties": { "success": { "type": "boolean", "example": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AdmitCardItem" } }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "500": { "description": "Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } } } } }, "/results": { "get": { "operationId": "listResults", "summary": "List Official Exam Results & Cut-Off Marks", "description": "Query published scorecards, merit lists, and category-wise cut-offs.", "tags": [ "Results" ], "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque cursor token for agent-friendly cursor-based streaming pagination", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Maximum items per page (default 20, max 100)", "schema": { "type": "integer", "default": 20 } }, { "name": "page", "in": "query", "description": "Page index for offset pagination (default 1)", "schema": { "type": "integer", "default": 1 } }, { "name": "search", "in": "query", "description": "Search query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Exam results list with pagination", "content": { "application/json": { "schema": { "type": "object", "required": [ "success", "data", "pagination" ], "properties": { "success": { "type": "boolean", "example": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ResultItem" } }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "500": { "description": "Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } } } } }, "/answerkeys": { "get": { "operationId": "listAnswerKeys", "summary": "List Answer Keys & Objection Windows", "description": "Fetch provisional/final answer keys and objection challenge dates.", "tags": [ "Answer Keys" ], "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque cursor token for agent-friendly cursor-based streaming pagination", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Maximum items per page (default 20, max 100)", "schema": { "type": "integer", "default": 20 } }, { "name": "page", "in": "query", "description": "Page index for offset pagination (default 1)", "schema": { "type": "integer", "default": 1 } }, { "name": "search", "in": "query", "description": "Search query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Answer keys list with pagination", "content": { "application/json": { "schema": { "type": "object", "required": [ "success", "data", "pagination" ], "properties": { "success": { "type": "boolean", "example": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AnswerKeyItem" } }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "500": { "description": "Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } } } } }, "/scholarships": { "get": { "operationId": "listScholarships", "summary": "List Financial Grants & Scholarships", "description": "Fetch student scholarships and financial assistance programs.", "tags": [ "Scholarships" ], "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque cursor token for agent-friendly cursor-based streaming pagination", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Maximum items per page (default 20, max 100)", "schema": { "type": "integer", "default": 20 } }, { "name": "page", "in": "query", "description": "Page index for offset pagination (default 1)", "schema": { "type": "integer", "default": 1 } }, { "name": "search", "in": "query", "description": "Search query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Scholarships list with pagination", "content": { "application/json": { "schema": { "type": "object", "required": [ "success", "data", "pagination" ], "properties": { "success": { "type": "boolean", "example": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ScholarshipItem" } }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "500": { "description": "Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } } } } }, "/yojana": { "get": { "operationId": "listSarkariYojana", "summary": "List Welfare Schemes & Citizen Benefits", "description": "Fetch citizen welfare initiatives, financial assistance, and online procedures.", "tags": [ "Yojana" ], "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque cursor token for agent-friendly cursor-based streaming pagination", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Maximum items per page (default 20, max 100)", "schema": { "type": "integer", "default": 20 } }, { "name": "page", "in": "query", "description": "Page index for offset pagination (default 1)", "schema": { "type": "integer", "default": 1 } }, { "name": "search", "in": "query", "description": "Search query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Sarkari Yojana list with pagination", "content": { "application/json": { "schema": { "type": "object", "required": [ "success", "data", "pagination" ], "properties": { "success": { "type": "boolean", "example": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/YojanaItem" } }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "500": { "description": "Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } } } } }, "/exam-calendar": { "get": { "operationId": "getExamCalendar", "summary": "Get Chronological Government Exam Schedule", "description": "Retrieve annual calendar schedules across major recruitment bodies.", "tags": [ "Exam Calendar" ], "parameters": [ { "name": "cursor", "in": "query", "description": "Opaque cursor token for agent-friendly cursor-based streaming pagination", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Maximum items per page (default 20, max 100)", "schema": { "type": "integer", "default": 20 } }, { "name": "page", "in": "query", "description": "Page index for offset pagination (default 1)", "schema": { "type": "integer", "default": 1 } }, { "name": "year", "in": "query", "description": "Calendar year filter (e.g. 2026)", "schema": { "type": "integer", "default": 2026 } } ], "responses": { "200": { "description": "Exam calendar entries with pagination", "content": { "application/json": { "schema": { "type": "object", "required": [ "success", "data", "pagination" ], "properties": { "success": { "type": "boolean", "example": true }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ExamCalendarItem" } }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } }, "500": { "description": "Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } } } } } } }, "components": { "schemas": { "PaginationMeta": { "type": "object", "required": [ "total", "limit", "page", "totalPages", "hasNextPage" ], "description": "Standard agent-friendly pagination metadata envelope supporting both offset and cursor-based navigation", "properties": { "total": { "type": "integer", "description": "Total number of records matching query filter", "example": 1250 }, "limit": { "type": "integer", "description": "Number of items returned in current page", "example": 20 }, "page": { "type": "integer", "description": "Current 1-indexed page number", "example": 1 }, "totalPages": { "type": "integer", "description": "Total number of pages available", "example": 63 }, "hasNextPage": { "type": "boolean", "description": "Whether additional pages are available", "example": true }, "nextCursor": { "type": "string", "description": "Opaque cursor token for agent-friendly streaming pagination", "example": "eyJsYXN0SWQiOiI2NmExMmIzYyJ9" }, "prevCursor": { "type": "string", "description": "Cursor token for previous page", "example": null } } }, "HealthStatus": { "type": "object", "required": [ "status", "message", "timestamp" ], "properties": { "status": { "type": "string", "example": "OK" }, "message": { "type": "string", "example": "SarkariAdda24x7.com API is running" }, "database": { "type": "string", "example": "connected" }, "timestamp": { "type": "string", "format": "date-time", "example": "2026-09-07T00:00:00.000Z" } } }, "ErrorModel": { "type": "object", "required": [ "success", "code", "message" ], "description": "RFC 9457 compliant typed error model for machine-readable client failure handling", "properties": { "success": { "type": "boolean", "example": false }, "code": { "type": "string", "example": "RESOURCE_NOT_FOUND", "description": "Machine-readable error identifier" }, "message": { "type": "string", "example": "The requested resource was not found.", "description": "Human-readable error explanation" }, "details": { "type": "object", "description": "Optional error context or field-level validation errors" }, "timestamp": { "type": "string", "format": "date-time", "example": "2026-09-07T00:00:00.000Z" } } }, "JobItem": { "type": "object", "required": [ "_id", "title", "slug", "organization" ], "properties": { "_id": { "type": "string", "example": "66a12b3c4d5e6f7a8b9c0d1e" }, "title": { "type": "string", "example": "SSC CGL 2026 Recruitment Online Form" }, "slug": { "type": "string", "example": "ssc-cgl-2026-recruitment-online-form-66a12b" }, "organization": { "type": "string", "example": "Staff Selection Commission" }, "totalPosts": { "type": "integer", "example": 17727 }, "category": { "type": "string", "example": "SSC" }, "state": { "type": "string", "example": "All India" }, "qualification": { "type": "array", "items": { "type": "string" }, "example": [ "Bachelor's Degree" ] }, "importantDates": { "type": "object", "properties": { "applicationStart": { "type": "string", "example": "2026-06-24" }, "lastDateApply": { "type": "string", "example": "2026-07-24" }, "examDate": { "type": "string", "example": "September 2026" } } }, "officialWebsite": { "type": "string", "example": "https://ssc.gov.in" } } }, "AdmitCardItem": { "type": "object", "required": [ "_id", "title", "slug", "organization" ], "properties": { "_id": { "type": "string", "example": "66a12b3c4d5e6f7a8b9c0d1f" }, "title": { "type": "string", "example": "UPSC Civil Services Prelims Admit Card 2026" }, "slug": { "type": "string", "example": "upsc-civil-services-prelims-admit-card-2026-66a12b" }, "organization": { "type": "string", "example": "Union Public Service Commission" }, "admitCardReleaseDate": { "type": "string", "example": "2026-05-15" }, "examDate": { "type": "string", "example": "2026-05-26" }, "downloadUrl": { "type": "string", "example": "https://upsconline.nic.in" } } }, "ResultItem": { "type": "object", "required": [ "_id", "title", "slug", "organization" ], "properties": { "_id": { "type": "string", "example": "66a12b3c4d5e6f7a8b9c0d20" }, "title": { "type": "string", "example": "Railway RRB NTPC Final Selection List 2026" }, "slug": { "type": "string", "example": "railway-rrb-ntpc-final-selection-list-2026-66a12b" }, "organization": { "type": "string", "example": "Railway Recruitment Board" }, "resultDate": { "type": "string", "example": "2026-08-10" }, "resultUrl": { "type": "string", "example": "https://rrbcdg.gov.in" } } }, "AnswerKeyItem": { "type": "object", "required": [ "_id", "title", "slug", "organization" ], "properties": { "_id": { "type": "string", "example": "66a12b3c4d5e6f7a8b9c0d21" }, "title": { "type": "string", "example": "SSC CHSL Tier 1 Provisional Answer Key 2026" }, "slug": { "type": "string", "example": "ssc-chsl-tier-1-provisional-answer-key-2026-66a12b" }, "organization": { "type": "string", "example": "Staff Selection Commission" }, "challengeStartDate": { "type": "string", "example": "2026-07-15" }, "challengeEndDate": { "type": "string", "example": "2026-07-20" }, "answerKeyUrl": { "type": "string", "example": "https://ssc.gov.in" } } }, "ScholarshipItem": { "type": "object", "required": [ "_id", "title", "slug", "provider" ], "properties": { "_id": { "type": "string", "example": "66a12b3c4d5e6f7a8b9c0d22" }, "title": { "type": "string", "example": "National Scholarship Portal (NSP) Post Matric 2026" }, "slug": { "type": "string", "example": "nsp-post-matric-scholarship-2026-66a12b" }, "provider": { "type": "string", "example": "Ministry of Minority Affairs" }, "benefitAmount": { "type": "string", "example": "Up to ₹20,000 per annum" }, "applicationDeadline": { "type": "string", "example": "2026-11-30" } } }, "YojanaItem": { "type": "object", "required": [ "_id", "title", "slug", "schemeName" ], "properties": { "_id": { "type": "string", "example": "66a12b3c4d5e6f7a8b9c0d23" }, "title": { "type": "string", "example": "PM Kisan Samman Nidhi Yojana 18th Installment 2026" }, "slug": { "type": "string", "example": "pm-kisan-samman-nidhi-18th-installment-66a12b" }, "schemeName": { "type": "string", "example": "PM Kisan Samman Nidhi" }, "ministry": { "type": "string", "example": "Ministry of Agriculture and Farmers Welfare" }, "financialAssistance": { "type": "string", "example": "₹6,000 per annum in three installments" } } }, "ExamCalendarItem": { "type": "object", "required": [ "_id", "title", "conductingBody", "calendarYear" ], "properties": { "_id": { "type": "string", "example": "66a12b3c4d5e6f7a8b9c0d24" }, "title": { "type": "string", "example": "UPSC Annual Examination Calendar 2026" }, "conductingBody": { "type": "string", "example": "Union Public Service Commission" }, "calendarYear": { "type": "integer", "example": 2026 }, "examDate": { "type": "string", "example": "2026-05-26" } } } }, "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Required only for administrative and ingestion operations. All public content reading endpoints are completely open and require no authorization headers." } } } }