> ## Documentation Index > Fetch the complete documentation index at: https://docs.anysite.io/llms.txt > Use this file to discover all available pages before exploring further. # /usajobs/jobs > Get one US federal job announcement from USAJOBS by its control number. Returns the full announcement: title, department, agency and hiring organization, summary, duties, requirements (conditions of employment, qualifications, education), how applicants are evaluated, required documents, how to apply and the next steps of the hiring process, plus the overview metadata — application status, posting and closing dates, duty locations with vacancy counts, salary, pay scale and grade, promotion potential, work schedule, appointment type, travel, supervisory status, telework and remote eligibility, relocation, drug test, financial disclosure, union representation, federal service type, security clearance and position sensitivity — together with the hiring paths the job is open to and the agency contact details. **Price:** 5 credits **⚠️ Common errors:** 412: The announcement does not exist or has been removed from USAJOBS ## OpenAPI ````yaml /openapi/jobs.json post /api/usajobs/jobs openapi: 3.1.0 info: title: Any Site API description: >+ Any Site API provides programmatic access to data from LinkedIn, Instagram, Twitter, and other platforms. ## Authentication All API endpoints require an `access-token` header with a valid API token. Tokens can be created in the [dashboard](https://app.anysite.io/). ## Pricing Each endpoint has a credit cost listed in its description. Credits are deducted from your token balance per request. version: 0.0.1 servers: [] security: - AccessToken: [] paths: /api/usajobs/jobs: post: tags: - /usajobs summary: /usajobs/jobs description: >- Get one US federal job announcement from USAJOBS by its control number. Returns the full announcement: title, department, agency and hiring organization, summary, duties, requirements (conditions of employment, qualifications, education), how applicants are evaluated, required documents, how to apply and the next steps of the hiring process, plus the overview metadata — application status, posting and closing dates, duty locations with vacancy counts, salary, pay scale and grade, promotion potential, work schedule, appointment type, travel, supervisory status, telework and remote eligibility, relocation, drug test, financial disclosure, union representation, federal service type, security clearance and position sensitivity — together with the hiring paths the job is open to and the agency contact details. **Price:** 5 credits **⚠️ Common errors:** 412: The announcement does not exist or has been removed from USAJOBS operationId: __api_usajobs_jobs_post parameters: - name: access-token in: header required: true schema: anyOf: - type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UsajobsJobsPayload' responses: '200': description: Successful Response content: application/json: schema: type: array items: $ref: '#/components/schemas/UsajobsJob' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: UsajobsJobsPayload: properties: timeout: type: integer maximum: 1500 minimum: 20 default: 300 job: type: string type: object required: - job UsajobsJob: properties: '@type': type: string default: UsajobsJob id: type: string announcement_number: anyOf: - type: string - type: 'null' job_title: anyOf: - type: string - type: 'null' url: anyOf: - type: string - type: 'null' department: anyOf: - type: string - type: 'null' agency: anyOf: - type: string - type: 'null' hiring_organization: anyOf: - type: string - type: 'null' application_status: anyOf: - type: string - type: 'null' posted_display: anyOf: - type: string - type: 'null' close_date_display: anyOf: - type: string - type: 'null' vacancy_display: anyOf: - type: string - type: 'null' locations: items: $ref: '#/components/schemas/UsajobsJobLocation' type: array default: [] summary: anyOf: - type: string - type: 'null' duties: anyOf: - type: string - type: 'null' requirements: anyOf: - type: string - type: 'null' evaluation: anyOf: - type: string - type: 'null' required_documents: anyOf: - type: string - type: 'null' how_to_apply: anyOf: - type: string - type: 'null' next_steps: anyOf: - type: string - type: 'null' salary: anyOf: - type: string - type: 'null' pay_scale_and_grade: anyOf: - type: string - type: 'null' promotion_potential: anyOf: - type: string - type: 'null' work_schedule: anyOf: - type: string - type: 'null' appointment_type: anyOf: - type: string - type: 'null' travel_required: anyOf: - type: string - type: 'null' is_supervisory: anyOf: - type: boolean - type: 'null' is_telework_eligible: anyOf: - type: boolean - type: 'null' is_remote: anyOf: - type: boolean - type: 'null' is_relocation_reimbursed: anyOf: - type: boolean - type: 'null' is_drug_test_required: anyOf: - type: boolean - type: 'null' is_financial_disclosure_required: anyOf: - type: boolean - type: 'null' is_union_represented: anyOf: - type: boolean - type: 'null' federal_service_type: anyOf: - type: string - type: 'null' security_clearance: anyOf: - type: string - type: 'null' position_sensitivity: anyOf: - type: string - type: 'null' hiring_paths: items: $ref: '#/components/schemas/UsajobsJobHiringPath' type: array default: [] contact: anyOf: - $ref: '#/components/schemas/UsajobsJobContact' - type: 'null' type: object required: - id HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array type: object UsajobsJobLocation: properties: '@type': type: string default: UsajobsJobLocation name: type: string vacancy_count: anyOf: - type: integer - type: 'null' type: object required: - name UsajobsJobHiringPath: properties: '@type': type: string default: UsajobsJobHiringPath code: type: string name: anyOf: - type: string - type: 'null' type: object required: - code UsajobsJobContact: properties: '@type': type: string default: UsajobsJobContact name: anyOf: - type: string - type: 'null' phone: anyOf: - type: string - type: 'null' fax: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' website_url: anyOf: - type: string - type: 'null' address: anyOf: - type: string - type: 'null' type: object ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array msg: type: string type: type: string input: {} ctx: type: object type: object required: - loc - msg - type securitySchemes: AccessToken: type: apiKey in: header name: access-token description: API token from the dashboard ````