Skip to main content

Placing an order

Place an order by creating a FHIR ServiceRequest. When you call this endpoint, a kit of the type specified will be sent to the patient’s home. The address the kit will be sent to must be specified when creating the patient.

The following fields are required:

  • Patient in subject. Note the prefix Patient/. All references in fhir are prefixed with the resource type.
  • A SKU in ServiceRequest.code.coding[]. Reach out for the SKUs relevant to your needs. These are available after panels are finalized.

For example:

curl -X POST https://api.kit.com/fhir/R4/ServiceRequest \
    -H "Authorization: Bearer $MY_ACCESS_TOKEN" \
    -H "Content-Type: application/fhir+json" \
    -d '{
        "resourceType":"ServiceRequest",
        "subject":{
            "reference":"Patient/3b9dc2ca-ff9b-4921-a61b-142420d382fa",
            "display":"Test Patient"
        },
        "code":{
            "coding":[{
                "system": "https://kit.com/sku",
                "code": "FME-1-KIT-FL",
            }]
        }
    }'

On success, the response will be the ServiceRequest resource with additional metadata such as the ID.

For more information about FHIR ServiceRequests: