...
The startSearch endpoint is used to submit a search request to the Search & Match Service. This call returns a searchId for the search.
| SendPost |
|---|
startSearch |
| Expand |
|---|
| | Field | Details |
|---|
| 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 |
|
| Expand |
|---|
| | Field | Details |
|---|
| searchId | integer
nullable: false
minimum: 1 |
|
|
...
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.
| SendGet |
|---|
| retrieveSearchResultsSummary |
| Expand |
|---|
| | Field | Details |
|---|
| searchId* | integer Unique identifier of the search. Can be determined by retrieving patient search summary |
|
| Expand |
|---|
| | Field | Details |
|---|
| 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 |
|
|
...
The retrieveSearchResultsDonors endpoint is used to retrieve search results for donors. Pagination is possible and optional filters can be provided.
| SendPost |
|---|
| retrieveSearchResultsDonors |
| Expand |
|---|
| | Field | Details |
|---|
| pagination | {...} | | searchId* | integer
nullable: false
minimum: 1 | | filters | {...} | | sortBy | string
nullable: true
default: standard
Enum:
Array [ 2 ] |
|
| Expand |
|---|
| | Field | Details |
|---|
| paging* | {...} | | searchResults* | [...] |
|
|
...
The retrieveFullReportDonors endpoint is used to retrieve all available information for a specific donor in a search result.
| SendGet |
|---|
| retrieveSearchResultsDonors |
| Expand |
|---|
| | Field | Details |
|---|
| searchResultsId | integer Unique identifier for the donor within a search result. This is the "id" field within a searchResult |
|
| Expand |
|---|
| | Field | Details |
|---|
| searchId | integer
nullable: false
minimum: 1 | | searchType | string
Enum:
Array [ 1 ] | | matchDuration | integer
minimum: 0
nullable: true
example: 30time in seconds that the search took to run on the matching engine | | patient | {...} | | search | {...} | | donor | {...} |
|
|
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.
| SendPost |
|---|
| retrieveSearchResultsCBUs |
| Expand |
|---|
| | Field | Details |
|---|
| pagination | {...} | | searchId* | integer
nullable: false
minimum: 1 | | filters | {...} | | sortBy | string
nullable: true
default: standardEnum:
Array [ 2 ] | | threeFourMismatchSortBy | string
nullable: true
default: resolutionScoreEnum:
Array [ 3 ] | | secondarySortBy | string
nullable: true
default: tncCountEnum:
Array [ 2 ] |
|
| Expand |
|---|
| | Field | Details |
|---|
| paging* | {...} | | searchResults* | [...] |
|
|
...
The retrieveFullReportCBUs endpoint is used to retrieve all available information for a specific CBU in a search result.
| SendGet |
|---|
| retrieveFullReportCBUs |
| Expand |
|---|
| | Field | Details |
|---|
| searchResultsId | integer Unique identifier of the search. Can be determined by retrieving patient search summary |
|
| Expand |
|---|
| | Field | Details |
|---|
| 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 | | search | {...} | | patient | {...} | | cbu | {...} |
|
|
4.7 - Suggested use of API endpoints
...