Skip to main content

Recruitment Bulk Import and Export API

Summary​

Six native operations export or import candidate, offer, and interview-feedback CSV data.

Audience​

Developers, QA and support engineers, implementation partners, architects, and security reviewers.

Reference Content​

MethodRelative routePurpose
GET/recruitment/export/candidatesCandidate CSV
GET/recruitment/export/offersOffer CSV
GET/recruitment/export/interview-feedbackInterview-feedback CSV
POST/recruitment/import/candidatesCandidate CSV import
POST/recruitment/import/offersOffer CSV import
POST/recruitment/import/interview-feedbackInterview-feedback CSV import

Exports return text CSV and neutralize formula-leading cells. Imports read the request body and return aggregate import/error counts. Candidate import writes directly through the DbContext; offer and feedback imports invoke command services per row.

Schemas, sample rows, personal data, notes, and offer values are intentionally excluded. File-size limits, transactional batch behavior, dry-run support, authorization, retention, and formal backfill/parity tooling are Not implemented.

Response and Errors​

Successful Result-based operations return direct values. Confirmed failure mappings are 400 validation, 404 missing resource, and 409 conflict with a message object. Direct queries and diagnostics return their source-defined shapes.

Requires confirmation​

Endpoint authorization, production exposure, privacy controls, ownership, operational limits, and compatibility parity require confirmation.

Source References​

  • microservices/src/recruitment-service/Api/RecruitmentEndpoints.cs
  • microservices/src/recruitment-service/Application/Queries/RecruitmentQueries.cs
  • microservices/src/recruitment-service/Application/Commands/OfferCommands.cs
  • microservices/src/recruitment-service/Application/Commands/InterviewCommands.cs

See Also​

Keywords​

  • Recruitment API
  • Source-backed endpoint reference

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-16
  • Review cycle: Quarterly