End point

/v2/market/search

Request format

POST

Request content

Json containing search parameteres. Example:

{

"id": "0",

"text": "Java Kotlin",

"textMatchType": "Or",

"extent": {"Start": "0", "End": "50"},

"locations": [

{"countryId": "22", "city": "Stockholm" }

],

"competenceAreas": [1]

}

Property Name	Type	Required	Description
id	integer	No	Id of search profile to use. If this is specified, no other properties in the json will be used when searching. To find the id of a search profile, login with the user whose search profile you want to use, and go to this page: https://localhost.brainville.com/MyProfile/SearchProfile/List/
text		No
textMatchType	string	No	How to match your search or - At least one word must match. Related words are included. This is the default and - All words must match. Related words are included exact - All words must match
locations	List of custom	No	List of locations
extent	custom	No	Extent range (in % of full time) of assignment Format: { "start" : [integer], "end": [integer] }
competenceAreas	List of integer	No	Integer list of matching competence areas. Id for each competence area can be found here: https://www.brainville.com/content/xml/industries.xml
allowRemote	boolean	No	Include assignments that allow remote work
allowOnsite	boolean	No	Include assignments that allow for onsite work
allowHybrid	boolean	No	Include assignments that allow for hybrid work (work that is partly remote, partly onsite)
categories	List of string	No	List of matching assignment categories. The categories are: Resource CompanyCommitment Hardware LicenseSoftware

Response Messages

Json list of matching assignments. Example:

{
    "results": [
        {
            "id": 1,
            "title": "Lead Mainframe Developer (Cobol)",
            "referenceNumber": null,
            "text": "Looking for Lead Mainframe Developer",
            "tags": [
                "SQL",
                "Cobol",
                "Jira",
                "DB2",
                "Confluence",
                "Mainframe",
                "ServiceNow",
                "CICS"
            ],
            "created": "2026-02-13T09:16:45.787",
            "updated": null,
            "company": "ACME Inc",
            "assignmentStartDate": null,
            "assignmentEndDate": null,
            "optionDate": null,
            "publicationEndDate": "2026-05-25T23:59:59",
            "competenceAreaId": 1,
            "extent": {
                "type": 1,
                "value": 100.0
            },
            "allowRemote": "Partly",
            "acceptSubcontractors": false,
            "category": "Resource",
            "endClientStatus": "NotSet",
            "endClientName": null,
            "level": "High",
            "maxRate": {
                "amount": 800.0,
                "currency": "SEK",
                "type": "PerHour",
                "display": "Mandatory"
            },
            "locations": [
                {
                    "countryId": 25,
                    "regionId": 62,
                    "city": "Helsinki",
                    "country": "Finland",
                    "region": "Uusimaa"
                }
            ],
            "roles": [
                "COBOL developer"
            ],
            "url": "https://www.brainville.com/Market/RequisitionSearchResult/Details/1",
            "applicationUrl": "https://www.brainville.com/Market/Offer/CreateOfferProfile?requisitionId=1"
        },
        {
            "id": 3,
            "title": "Cobolutvecklare",
            "referenceNumber": "ABC",
            "text": "<b>Uppdragsbeskrivning</b><br/>Vi söker en erfaren Cobol-utvecklare",
            "tags": [
            ],
            "created": "2026-02-04T09:52:30.987",
            "updated": null,
            "company": "Company X",
            "assignmentStartDate": "2026-03-23T00:00:00",
            "assignmentEndDate": "2026-09-23T00:00:00",
            "optionDate": null,
            "publicationEndDate": "2026-05-27T23:59:59",
            "competenceAreaId": 1,
            "extent": {
                "type": 1,
                "value": 100.0
            },
            "allowRemote": "No",
            "acceptSubcontractors": false,
            "category": "Resource",
            "endClientStatus": "NotSet",
            "endClientName": null,
            "level": "Medium",
            "maxRate": {
                "amount": 0.0,
                "currency": "EUR",
                "type": "PerHour",
                "display": "Negotiable"
            },
            "locations": [
                {
                    "countryId": 22,
                    "regionId": 12,
                    "city": "Stockholm",
                    "country": "Sweden",
                    "region": "Stockholm"
                }
            ],
            "roles": [
                "COBOL developer"
            ],
            "url": "https://localhost.brainville.com/Market/RequisitionSearchResult/Details/3",
            "applicationUrl": "https://localhost.brainville.com/Market/Offer/CreateOfferProfile?requisitionId=3"
        },        
    ],
    "exportedInPeriod": 2,
    "volume": 100,
    "period": {
        "startDate": "2026-03-24T09:28:42",
        "endDate": "2026-04-23T23:59:59"
    },
    "actualResultCount": 2
}