4.1 - Start search
The startSearch endpoint is used to submit a search request to the Search & Match Service. This call returns a searchId for the search.
| Send |
|---|
startSearch |
| wmdaId* | integer
example: 123456
nullable: false | | matchEngine* | integer
nullable: falseUnique identifier of match engine used in the search. Allowed: 2 (HAP-E), 3 (ATLAS). Enum:
Array [ 2 ] | | searchType* | string
example: DREnum:
Array [ 2 ] | | overallMismatches | integer
default: 0Enum:
Array [ 8 ] | | lociToBeConsidered | [...] | | isCbuAbLowDrb1HighResolution | boolean
default: false
nullable: true |
|
| searchId | integer
nullable: false
minimum: 1 |
|
|
4.2 - Search summary
The retrieveSearchResultssummary endpoint is used to request a search summary for a search. It also contains the status of a search and can therefore be used to check whether a search is done.
| Send |
|---|
| retrieveSearchResultssummary |
| patient | {...} | | searchId* | integer
nullable: false
minimum: 1 | | searchType* | stringEnum:
Array [ 1 ] | | matchEngine* | integer
nullable: falseUnique identifier of match engine used in the search. Allowed: 2 (HAP-E), 3 (ATLAS). Enum:
Array [ 2 ] | | overallMismatches* | integer
default: 0Enum:
Array [ 8 ] | | status* | string
nullable: falseEnum:
Array [ 3 ] | | summary* | {...} | | inexplicable* | integer
nullable: trueTotal number of donors which phenotype cannot be explained by known haplotype | | statistics* | {...} | | error* | {...}
nullable: true | | lociToBeConsidered | [...] | | lastUpdated | string($date-time)
nullable: false
maxLength: 255needed to help determine when patient can be automatically moved to STP state |
|
|
4.3 - Search results - Donors
The retrieveSearchResultsDonors endpoint is used to retrieve search results for donors. Pagination is possible and optional filters can be provided.
| Send |
|---|
| retrieveSearchResultsDonors |
| pagination | {...} | | searchId* | integer
nullable: false
minimum: 1 | | filters | {...} | | sortBy | string
nullable: true
default: standardEnum:
Array [ 2 ] |
|
| paging* | {...} | | searchResults* | [...] |
|
|
4.4 - Full report - Donors
The retrieveFullReportDonors endpoint is used to retrieve all available information for a specific donor in a search result.
| Send |
|---|
| retrieveSearchResultsDonors |
{ | searchId | integer
nullable: false
minimum: 1 | | searchType | stringEnum:
Array [ 1 ] | | matchDuration | integer
minimum: 0
nullable: true
example: 30time in seconds that the search took to run on the matching engine | | patient | {...} | | donor | {...} |
} | integer
nullable: false
minimum: 1 |
|
|
4.5 - Search results - CBUs
The retrieveSearchResultsDonors endpoint is used to retrieve search results for cord blood units. Pagination is possible and optional filters can be provided.
4.6 - Full report - CBUs
The retrieveFullReportCBUs endpoint is used to retrieve all available information for a specific CBU in a search result.
| Send |
|---|
| retrieveFullReportCBUs |
Request | searchId | integer
nullable: false
minimum: 1 |
|
| searchResultsId | integer Unique identifier of the search. Can be determined by retrieving patient search summary |
Response | searchId | integer
nullable: false
minimum: 1 |
|
|
4.7 - Suggested use of API endpoints
Below is a diagram indicated the suggested use of some of the API endpoints. More API endpoints are available and the API implementer may choose to implement the endpoints in another order.
