Skip to main content

Get All Position Steps & All Applicants

This endpoint retrieves comprehensive information about a specific position, including all steps and all applicants assigned to each step.

Endpoint Overview​

  • HTTP Method: GET
  • Endpoint URL:
    https://api.vinter.me/api/v1/Position/GetStepsAndAllApplicants?positionId=371473fc-656d-41ef-8887-3a4c5d544eca

Request Headers​

Header NameDescriptionExample Value
X-Api-KeyAPI key for organizational authentication.api_key
Content-TypeSpecifies the media type of the request.application/json

Response Format​

A successful request returns a JSON object structured as follows:

{
  "data": {
    "positionId": "371473fc-656d-41ef-8887-3a4c5d544eca",
    "title": "Senior Software Architect",
    "status": "active",
    "responsibleName": "Kaan KIVIRCIK",
    "language": "tr-TR",
    "location": "İzmir, Turkey",
    "createdAt": "2025-05-07T12:05:48.508927+00:00",
    "completedDate": null,
    "activatedDate": "2025-05-07T12:05:48.504923+00:00",
    "positionSteps": [
      {
        "stepName": "Yetkinlik Envanteri Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
          {
            "applicationStepId": "1bc078a6-8c2c-415f-bea5-86312d6108f2",
            "fullName": "Murat ŞAHİN",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          },
          {
            "applicationStepId": "9fcfdae7-3b05-4753-a944-a7398131454d",
            "fullName": "Musa ERTEK",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          }
        ]
      },
      {
        "stepName": "Teknik Değerlendirme Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
          {
            "applicationStepId": "1ef4655f-6f77-4d6c-b6e3-73d4fb175d2d",
            "fullName": "Şükran ÖZBEK",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          },
          {
            "applicationStepId": "ac512aeb-6c27-414b-8cda-6497500952bd",
            "fullName": "Yağız TÜRER",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          }
        ]
      },
      {
        "stepName": "Bilişsel Yetenek Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
          {
            "applicationStepId": "4aa949f3-b1e5-44c8-a274-aa4ca7d90438",
            "fullName": "Alper ÖZER",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          },
          {
            "applicationStepId": "07fa2316-82a2-4ede-8656-90766ffc7957",
            "fullName": "Ecem Yazgı BEKİM",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          }
        ]
      },
      {
        "stepName": "Yabancı Dil Yeterlilik Testi",
        "isStaticStep": false,
        "staticStepId": null,
        "applicants": [
          {
            "applicationStepId": "5839b683-1dc9-4672-aab6-044d4c7bd740",
            "fullName": "Batuhan SEYMAN",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          },
          {
            "applicationStepId": "320df362-4717-40eb-92b9-4e471dc7b95d",
            "fullName": "Aydın BAŞAK",
            "email": "[email protected]",
            "stepVinterScore": null,
            "stepStatus": "expected"
          }
        ]
      }
    ]
  },
  "success": true,
  "message": null,
  "isResourceKey": true
}

Detailed Field Descriptions​

  • positionId:
    The unique identifier of the position being retrieved.

  • title:
    The name of the position.

  • status:
    The current status of the position (e.g., "active", "inactive", "completed").

  • responsibleName:
    The name of the person responsible for the position.

  • language:
    The primary language associated with the position (e.g., "tr-TR", "en-US").

  • location:
    The geographic location of the position.

  • createdAt:
    The timestamp when the position was created.

  • completedDate:
    The timestamp when the position was completed (if applicable).

  • activatedDate:
    The timestamp when the position became active.

  • positionSteps:
    A comprehensive list of all steps associated with the position, including:

    • stepName: The name of the step
    • isStaticStep: Whether the step is a predefined static step
    • staticStepId: The ID of the static step (if applicable)
    • applicants: All applicants assigned to this step, with details including:
      • applicationStepId: Unique identifier for the application step
      • fullName: The full name of the applicant
      • email: The email address of the applicant
      • stepVinterScore: The Vinter score for this step (if available)
      • stepStatus: The current status of the applicant in this step

Use Cases​

  • Comprehensive Overview:
    This endpoint provides a complete view of all position steps and all applicants, making it ideal for comprehensive reporting and analysis.

  • Progress Monitoring:
    HR and recruitment teams can track the progression of all applicants across different steps in a single request.

  • Data Integration:
    Third-party systems can use this comprehensive data to provide detailed analytics on position performance and applicant distribution.

  • Administrative Control:
    Managers can get a full overview of the recruitment pipeline, identifying bottlenecks and optimizing the hiring process.