Skip to navigation
FJ Sourcing APIsSourcing Session

Create Sourcing Session

View as Markdown

POST /sourcing-session

Creates a new sourcing session and triggers the initial profile search.

Headers

KeyValue
x-fj-api-keyfjk_
Content-Typeapplication/json

Body

FieldTypeRequiredDescription
sessionTitlestringnoHuman-readable session name.
jdDetail.userTextstringnoFree-form JD text.
jdDetail.sampleProfileURLstringnoSample LinkedIn URL to anchor the search.
queriesobjectyesSearch filter map (see below).

queries object — filter shape

Each filter is { type, value }:

value accepts array of strings

For skills filter, at least one skill must be provided in mandatory, core, or secondary.

  • country_region — { type: "(.)", value: ["India"] }

  • open_to_cards — { type: "=", value: ["CAREER_INTEREST"] }

  • current_employers.title — { type: "IN", value: [ ".NET Developer", "C# Developer", "Software Engineer", "Web Developer", "Application Developer", "Backend Developer" ] }

  • years_of_experience_raw — { type: "RANGE", value: [1, 5] }

  • skills — { type: "IN", value: { mandatory: ["C#", ".NET Core"], core: [ "ASP.NET MVC", "Web API", "SQL Server", "Entity Framework", "React", "Angular", "Docker" ], secondary: [] } }

  • current_employers.function_category — { type: "IN", value: ["Engineering"] }

  • current_employers.seniority_level — { type: "IN", value: ["Senior"] }

  • current_employers.name — { type: "IN", value: ["Tech Mahindra"] }

  • current_employers.years_at_company — { type: "IN", value: ["1 to 2 years"] }

  • region — { type: "IN", value: ["Pune, Maharashtra, India"] }

  • all_employers.company_industries — { type: "IN", value: [ "Software Development", "IT System Custom Software Development", "Design Services" ] }

  • education_background.institute_name — { type: "IN", value: ["University of Mumbai"] }

  • education_background.field_of_study — { type: "IN", value: [ "Computer Science", "Information Technology", "related field" ] }

  • education_background.degree_name — { type: "IN", value: ["BACHELORS"] }

  • past_employers.name — { type: "IN", value: ["Infosys"] }

  • past_employers.title — { type: "IN", value: ["Software Developer"] }

  • current_employers.company_type — { type: "IN", value: ["Public Company"] }

  • current_employers.company_hq_location — { type: "IN", value: ["Pune, Maharashtra, India"] }

  • current_employers.description — { type: "IN", value: ["B2B Saas"] }

  • funding_stage — { type: "IN", value: ["series_a"] }

  • headcount_growth — { type: "RANGE", value: [10, 20] }

  • current_employers.company_headcount_latest — { type: "RANGE", value: [10, 100] }

  • annual_revenue — { type: "=", value: ["1_10"] }

  • total_funding — { type: "=", value: ["1_10"] }

  • year_founded — { type: "RANGE", value: [2000, 2010] }

  • recently_funded — { type: "=", value: ["6m"] }

  • certifications.name — { type: "IN", value: ["AWS Certified Cloud Practitioner"] }

  • honors.title — { type: "IN", value: ["Dean's list"] }

  • geo_distance — { type: "=", value: ["50_km"] }

  • current_employers.employment_type — { type: "IN", value: ["Part-time", "Permanent"] }

  • current_employers.company_headcount_range — { type: "IN", value: ["51-200"] }

Response (200)

The created session object.

{
    "statusCode": 201,
    "data": {
        "session": {
            "sessionTitle": ".NET Developer",
            "medium": "MANUAL",
            "jdDetail": {
                "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune",
                "sampleProfileURL": ""
            },
            "queries": {
                "country_region": {
                    "type": "(.)",
                    "value": [
                        "India"
                    ]
                },
                "current_employers.title": {
                    "type": "IN",
                    "value": [
                        ".NET Developer"
                    ]
                },
                "years_of_experience_raw": {
                    "type": "RANGE",
                    "value": [
                        1,
                        5
                    ]
                },
                "region": {
                    "type": "IN",
                    "value": [
                        "Pune, Maharashtra, India"
                    ]
                },
                "skills": {
                    "type": "IN",
                    "value": {
                        "mandatory": [
                            "C#"
                        ],
                        "core": [
                            "ASP.NET MVC"
                        ],
                        "secondary": []
                    }
                }
            },
            "fallbackFilters": null,
            "hasUsedFinalFallback": false,
            "nuances": [],
            "redFlags": "",
            "mustHaves": "",
            "additionalNotes": "",
            "createdBy": "68c505c2ec8d7cb2821599af",
            "workspaceId": "6a0c5da36e7a0151430c5b71",
            "projectId": "6a0c5da36e7a0151430c5b7e",
            "next_cursor": "",
            "searchMoreCounter": 0,
            "filterChangesCounter": 0,
            "lastCandidatesFetchedAt": null,
            "profileMatchingStatus": "idle",
            "totalProfilesForMatching": 0,
            "totalProfilesMatched": 0,
            "profileMatchingProvider": "gemini",
            "sessionCreditCharged": false,
            "forceRefreshAnalysis": false,
            "totalAvailableProfiles": 0,
            "metadata": {
                "s3Key": null,
                "fileHash": null,
                "uploadedAt": null
            },
            "_id": "6a0c77936e7a0151430c91fd",
            "batches": [],
            "createdAt": "2026-05-19T14:45:39.240Z",
            "updatedAt": "2026-05-19T14:45:39.240Z",
            "__v": 0
        },
        "sourcing": {
            "total_display_count": 100,
            "next_cursor": "H4sIAJR3DGoC_xXMMQrDMAxA0asEzx0iS5biXqWUIMs2GUpNE2coIXdvuv4H_3CfvazfedFtcffB-VB5YovKIMQhawm5aCKIqRCaZBBkJWEZk6TRexBvqZrlSrnG4G6D29rar9eDAQgxwPNqvXV9zdb295_QT-cPbAjrQHoAAAA=",
            "filterChangesCounter": 0,
            "searchMoreCounter": 0,
            "profileMatchingStatus": "processing",
            "newProfilesCount": 100,
            "creditInfo": {
                "charged": true,
                "amount": 5,
                "reason": "Sourcing Session Created",
                "remainingCredits": 37
            }
        }
    },
    "message": "Session created successfully",
    "status": "SUCCESS"
}

cURL

Replace fjk_YOUR_API_KEY_HERE with your actual key, then paste and run:

curl -X POST "https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session" \
  -H "x-fj-api-key: fjk_YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionTitle": ".NET Developer",
    "jdDetail": {
      "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune"
    },
    "queries": {
      "country_region": {
        "type": "(.)",
        "value": ["India"]
      },
      "years_of_experience_raw": {
        "type": "RANGE",
        "value": [1, 5]
      },
      "skills": {
        "type": "IN",
        "value": {
          "mandatory": [
            "C#",
            ".NET Core"
          ],
          "core": [
            "ASP.NET MVC",
            "Web API",
            "SQL Server",
            "Entity Framework",
            "React",
            "Angular",
            "Docker"
          ],
          "secondary": []
        }
      }
    }
  }'

Errors

  • 400 Bad Request — validation failed (missing/invalid fields).

  • 401 Unauthorized — invalid API key.

  • 402 Payment Required — insufficient workspace credits.

Authentication

x-fj-api-keystring
API Key authentication via header

Request

This endpoint expects an object.
sessionTitlestringRequired
jdDetailobjectRequired
queriesobjectRequired

Response headers

X-Powered-BystringOptional
X-Request-IdstringOptional
Access-Control-Allow-CredentialsstringOptional
RateLimit-PolicystringOptional
RateLimit-LimitstringOptional
RateLimit-RemainingstringOptional
RateLimit-ResetstringOptional
ETagstringOptional

Response

Created
statusCodeinteger
dataobject
messagestring
statusstring