> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.joincandidhealth.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.joincandidhealth.com/_mcp/server.

# Update organization service facility

PATCH https://api.joincandidhealth.com/api/organization-service-facilities/v2/{organization_service_facility_id}
Content-Type: application/json

Reference: https://docs.joincandidhealth.com/api-reference/organization-service-facilities/v-2/update

## Authentication

- OAuth2 — send the obtained token as `Authorization: Bearer <token>`

## Servers

- `https://api.joincandidhealth.com` (Production, default)
- `https://api-staging.joincandidhealth.com` (Staging)
- `https://sandbox-api.joincandidhealth.com` (CandidSandbox)
- `https://staging-api.joincandidhealth.com` (CandidStaging)
- `http://localhost:5050` (Local)

## Request

### Path parameters

- `organization_service_facility_id` (UUID, required)

### Body (application/json)

This endpoint expects an OrganizationServiceFacilityUpdate.

- `name` (string, optional) — The name of the service facility.
- `aliases` (list of string, optional) — A list of alternate names for the service facility.
- `description` (string, optional) — A description of the service facility.
- `external_id` (string, optional) — An ID for this service facility used in an external system (e.g. your EMR). Service facilities can be queried by this field.
- `npi` (string, optional) — An NPI specific to the service facility if applicable, i.e. if it has one and is not under the billing provider's NPI. Box 32 section (a) of the CMS-1500 claim form.
- `place_of_service_code` (enum, optional) — The Place of Service (POS) code for this service facility.
  - Allowed values: `01`, `02`, `03`, `04`, `05`, `06`, `07`, `08`, `09`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `31`, `32`, `33`, `34`, `41`, `42`, `49`, `50`, `51`, `52`, `53`, `54`, `55`, `56`, `57`, `58`, `60`, `61`, `62`, `65`, `71`, `72`, `81`, `99`
- `clia_number` (string, optional) — The associated CLIA number with this service facility. Can be used to populate CLIA numbers on encounters.
- `mammography_certification_number` (string, optional) — The associated mammography certification number for this service facility. This is a 6 digit code assigned by the FDA.
- `status` (enum, optional) — The status of the service facility.
  - Allowed values: `active`, `inactive`, `suspended`
- `operational_status` (enum, optional) — The operational status of the service facility.
  - Allowed values: `C`, `H`, `I`, `K`, `O`, `U`
- `mode` (enum, optional) — The mode of the service facility.
  - Allowed values: `instance`, `kind`
- `type` (enum, optional) — The type of the service facility.
  - Allowed values: `DX`, `CVDX`, `CATH`, `ECHO`, `GIDX`, `ENDOS`, `RADDX`, `RADO`, `RNEU`, `HOSP`, `CHR`, `GACH`, `MHSP`, `PSYCHF`, `RH`, `RHAT`, `RHII`, `RHMAD`, `RHPI`, `RHPIH`, `RHPIMS`, `RHPIVS`, `RHYAD`, `HU`, `BMTU`, `CCU`, `CHEST`, `EPIL`, `ER`, `ETU`, `HD`, `HLAB`, `INLAB`, `OUTLAB`, `HRAD`, `HUSCS`, `ICU`, `PEDICU`, `PEDNICU`, `INPHARM`, `MBL`, `NCCS`, `NS`, `OUTPHARM`, `PEDU`, `PHU`, `RHU`, `SLEEP`, `NCCF`, `SNF`, `OF`, `ALL`, `AMPUT`, `BMTC`, `BREAST`, `CANC`, `CAPC`, `CARD`, `PEDCARD`, `COAG`, `CRS`, `DERM`, `ENDO`, `PEDE`, `ENT`, `FMC`, `GI`, `PEDGI`, `GIM`, `GYN`, `HEM`, `PEDHEM`, `HTN`, `IEC`, `INFD`, `PEDID`, `INV`, `LYMPH`, `MGEN`, `NEPH`, `PEDNEPH`, `NEUR`, `OB`, `OMS`, `ONCL`, `PEDHO`, `OPH`, `OPTC`, `ORTHO`, `HAND`, `PAINCL`, `PC`, `PEDC`, `PEDRHEUM`, `POD`, `PREV`, `PROCTO`, `PROFF`, `PROS`, `PSI`, `PSY`, `RHEUM`, `SPMED`, `SU`, `PLS`, `URO`, `TR`, `TRAVEL`, `WND`, `RTF`, `PRC`, `SURF`, `DADDR`, `MOBL`, `AMB`, `PHARM`, `ACC`, `COMM`, `CSC`, `PTRES`, `SCHOOL`, `UPC`, `WORK`
- `physical_type` (enum, optional) — The physical type of the service facility.
  - Allowed values: `si`, `bu`, `wi`, `wa`, `lvl`, `co`, `ro`, `bd`, `ve`, `ho`, `ca`, `rd`, `area`, `jdn`
- `telecoms` (list of string, optional) — A list of contact methods for the service facility.
- `address` (StreetAddressLongZip, optional) — The address of the service facility.

## Response

### 200

- `organization_service_facility_id` (UUID, required)
- `name` (string, required) — The name of the service facility.
- `aliases` (list of string, required) — A list of alternate names for the service facility.
- `telecoms` (list of string, required) — A list of contact methods for the service facility.
- `address` (StreetAddressLongZip, required) — The address of the service facility.
- `description` (string, optional) — A description of the service facility.
- `external_id` (string, optional) — An ID for this service facility used in an external system (e.g. your EMR). Service facilities can be queried by this field.
- `npi` (string, optional) — An NPI specific to the service facility if applicable, i.e. if it has one and is not under the billing provider's NPI. Box 32 section (a) of the CMS-1500 claim form.
- `place_of_service_code` (enum, optional) — The Place of Service (POS) code for this service facility.
  - Allowed values: `01`, `02`, `03`, `04`, `05`, `06`, `07`, `08`, `09`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `31`, `32`, `33`, `34`, `41`, `42`, `49`, `50`, `51`, `52`, `53`, `54`, `55`, `56`, `57`, `58`, `60`, `61`, `62`, `65`, `71`, `72`, `81`, `99`
- `clia_number` (string, optional) — The associated CLIA number with this service facility. Can be used to populate CLIA numbers on encounters.
- `mammography_certification_number` (string, optional) — The associated mammography certification number for this service facility. This is a 6 digit code assigned by the FDA.
- `status` (enum, optional) — The status of the service facility.
  - Allowed values: `active`, `inactive`, `suspended`
- `operational_status` (enum, optional) — The operational status of the service facility.
  - Allowed values: `C`, `H`, `I`, `K`, `O`, `U`
- `mode` (enum, optional) — The mode of the service facility.
  - Allowed values: `instance`, `kind`
- `type` (enum, optional) — The type of the service facility.
  - Allowed values: `DX`, `CVDX`, `CATH`, `ECHO`, `GIDX`, `ENDOS`, `RADDX`, `RADO`, `RNEU`, `HOSP`, `CHR`, `GACH`, `MHSP`, `PSYCHF`, `RH`, `RHAT`, `RHII`, `RHMAD`, `RHPI`, `RHPIH`, `RHPIMS`, `RHPIVS`, `RHYAD`, `HU`, `BMTU`, `CCU`, `CHEST`, `EPIL`, `ER`, `ETU`, `HD`, `HLAB`, `INLAB`, `OUTLAB`, `HRAD`, `HUSCS`, `ICU`, `PEDICU`, `PEDNICU`, `INPHARM`, `MBL`, `NCCS`, `NS`, `OUTPHARM`, `PEDU`, `PHU`, `RHU`, `SLEEP`, `NCCF`, `SNF`, `OF`, `ALL`, `AMPUT`, `BMTC`, `BREAST`, `CANC`, `CAPC`, `CARD`, `PEDCARD`, `COAG`, `CRS`, `DERM`, `ENDO`, `PEDE`, `ENT`, `FMC`, `GI`, `PEDGI`, `GIM`, `GYN`, `HEM`, `PEDHEM`, `HTN`, `IEC`, `INFD`, `PEDID`, `INV`, `LYMPH`, `MGEN`, `NEPH`, `PEDNEPH`, `NEUR`, `OB`, `OMS`, `ONCL`, `PEDHO`, `OPH`, `OPTC`, `ORTHO`, `HAND`, `PAINCL`, `PC`, `PEDC`, `PEDRHEUM`, `POD`, `PREV`, `PROCTO`, `PROFF`, `PROS`, `PSI`, `PSY`, `RHEUM`, `SPMED`, `SU`, `PLS`, `URO`, `TR`, `TRAVEL`, `WND`, `RTF`, `PRC`, `SURF`, `DADDR`, `MOBL`, `AMB`, `PHARM`, `ACC`, `COMM`, `CSC`, `PTRES`, `SCHOOL`, `UPC`, `WORK`
- `physical_type` (enum, optional) — The physical type of the service facility.
  - Allowed values: `si`, `bu`, `wi`, `wa`, `lvl`, `co`, `ro`, `bd`, `ve`, `ho`, `ca`, `rd`, `area`, `jdn`

## Errors

### 422 HTTP Request Validation Error

- `errorName` ("HttpRequestValidationError", required)
- `content` (RequestValidationError, required)

### 404 Entity Not Found Error

- `errorName` ("EntityNotFoundError", required)
- `content` (EntityNotFoundErrorMessage, required)

### 409 Entity Conflict Error

- `errorName` ("EntityConflictError", required)
- `content` (EntityConflictErrorMessage, required)

## Types

### StreetAddressLongZip

- `address1` (string, required)
- `city` (string, required)
- `state` (enum, required)
  - Allowed values: `AA`, `AE`, `AP`, `AL`, `AK`, `AS`, `AZ`, `AR`, `CA`, `CO`, `CT`, `DC`, `DE`, `FL`, `FM`, `GA`, `GU`, `HI`, `ID`, `IL`, `IN`, `IA`, `KS`, `KY`, `LA`, `ME`, `MD`, `MA`, `MH`, `MI`, `MN`, `MP`, `MS`, `MO`, `MT`, `NE`, `NV`, `NH`, `NJ`, `NM`, `NY`, `NC`, `ND`, `OH`, `OK`, `OR`, `PA`, `PR`, `PW`, `RI`, `SC`, `SD`, `TN`, `TX`, `UT`, `VI`, `VT`, `VA`, `WA`, `WV`, `WI`, `WY`, `FC`
- `zip_code` (string, required) — 5-digit zip code
- `zip_plus_four_code` (string, required) — 4-digit zip add-on code https://en.wikipedia.org/wiki/ZIP_Code#ZIP+4
- `address2` (string, optional)

### RequestValidationError

- `fieldName` (string, required)
- `humanReadableMessage` (string, optional)

### EntityNotFoundErrorMessage

- `id` (string, required)

### EntityConflictErrorMessage

- `entity_name` (string, required)

## Examples

**Request**

```json
{
  "name": "Test Service Facility",
  "aliases": [
    "Test Service Facility Alias"
  ],
  "description": "Test Service Facility Description",
  "status": "active",
  "operational_status": "C",
  "mode": "instance",
  "type": "DX",
  "physical_type": "si",
  "telecoms": [
    "555-555-5555"
  ],
  "address": {
    "address1": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zip_code": "10001",
    "zip_plus_four_code": "1234",
    "address2": "Apt 1"
  }
}
```

**Response**

```json
{
  "organization_service_facility_id": "30F55EE6-8C0E-43FC-A7FC-DAC00D5BF569",
  "name": "Test Service Facility",
  "aliases": [
    "Test Service Facility Alias"
  ],
  "telecoms": [
    "555-555-5555"
  ],
  "address": {
    "address1": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zip_code": "10001",
    "zip_plus_four_code": "1234",
    "address2": "Apt 1"
  },
  "description": "Test Service Facility Description",
  "status": "active",
  "operational_status": "C",
  "mode": "instance",
  "type": "DX",
  "physical_type": "si"
}
```

**SDK Code**

```python
import requests

url = "https://api.joincandidhealth.com/api/organization-service-facilities/v2/30F55EE6-8C0E-43FC-A7FC-DAC00D5BF569"

payload = {
    "name": "Test Service Facility",
    "aliases": ["Test Service Facility Alias"],
    "description": "Test Service Facility Description",
    "status": "active",
    "operational_status": "C",
    "mode": "instance",
    "type": "DX",
    "physical_type": "si",
    "telecoms": ["555-555-5555"],
    "address": {
        "address1": "123 Main St",
        "city": "New York",
        "state": "NY",
        "zip_code": "10001",
        "zip_plus_four_code": "1234",
        "address2": "Apt 1"
    }
}
headers = {
    "Authorization": "<token>.",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.joincandidhealth.com/api/organization-service-facilities/v2/30F55EE6-8C0E-43FC-A7FC-DAC00D5BF569';
const options = {
  method: 'PATCH',
  headers: {Authorization: '<token>.', 'Content-Type': 'application/json'},
  body: '{"name":"Test Service Facility","aliases":["Test Service Facility Alias"],"description":"Test Service Facility Description","status":"active","operational_status":"C","mode":"instance","type":"DX","physical_type":"si","telecoms":["555-555-5555"],"address":{"address1":"123 Main St","city":"New York","state":"NY","zip_code":"10001","zip_plus_four_code":"1234","address2":"Apt 1"}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.joincandidhealth.com/api/organization-service-facilities/v2/30F55EE6-8C0E-43FC-A7FC-DAC00D5BF569"

	payload := strings.NewReader("{\n  \"name\": \"Test Service Facility\",\n  \"aliases\": [\n    \"Test Service Facility Alias\"\n  ],\n  \"description\": \"Test Service Facility Description\",\n  \"status\": \"active\",\n  \"operational_status\": \"C\",\n  \"mode\": \"instance\",\n  \"type\": \"DX\",\n  \"physical_type\": \"si\",\n  \"telecoms\": [\n    \"555-555-5555\"\n  ],\n  \"address\": {\n    \"address1\": \"123 Main St\",\n    \"city\": \"New York\",\n    \"state\": \"NY\",\n    \"zip_code\": \"10001\",\n    \"zip_plus_four_code\": \"1234\",\n    \"address2\": \"Apt 1\"\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "<token>.")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.joincandidhealth.com/api/organization-service-facilities/v2/30F55EE6-8C0E-43FC-A7FC-DAC00D5BF569")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = '<token>.'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Test Service Facility\",\n  \"aliases\": [\n    \"Test Service Facility Alias\"\n  ],\n  \"description\": \"Test Service Facility Description\",\n  \"status\": \"active\",\n  \"operational_status\": \"C\",\n  \"mode\": \"instance\",\n  \"type\": \"DX\",\n  \"physical_type\": \"si\",\n  \"telecoms\": [\n    \"555-555-5555\"\n  ],\n  \"address\": {\n    \"address1\": \"123 Main St\",\n    \"city\": \"New York\",\n    \"state\": \"NY\",\n    \"zip_code\": \"10001\",\n    \"zip_plus_four_code\": \"1234\",\n    \"address2\": \"Apt 1\"\n  }\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.patch("https://api.joincandidhealth.com/api/organization-service-facilities/v2/30F55EE6-8C0E-43FC-A7FC-DAC00D5BF569")
  .header("Authorization", "<token>.")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Test Service Facility\",\n  \"aliases\": [\n    \"Test Service Facility Alias\"\n  ],\n  \"description\": \"Test Service Facility Description\",\n  \"status\": \"active\",\n  \"operational_status\": \"C\",\n  \"mode\": \"instance\",\n  \"type\": \"DX\",\n  \"physical_type\": \"si\",\n  \"telecoms\": [\n    \"555-555-5555\"\n  ],\n  \"address\": {\n    \"address1\": \"123 Main St\",\n    \"city\": \"New York\",\n    \"state\": \"NY\",\n    \"zip_code\": \"10001\",\n    \"zip_plus_four_code\": \"1234\",\n    \"address2\": \"Apt 1\"\n  }\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PATCH', 'https://api.joincandidhealth.com/api/organization-service-facilities/v2/30F55EE6-8C0E-43FC-A7FC-DAC00D5BF569', [
  'body' => '{
  "name": "Test Service Facility",
  "aliases": [
    "Test Service Facility Alias"
  ],
  "description": "Test Service Facility Description",
  "status": "active",
  "operational_status": "C",
  "mode": "instance",
  "type": "DX",
  "physical_type": "si",
  "telecoms": [
    "555-555-5555"
  ],
  "address": {
    "address1": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zip_code": "10001",
    "zip_plus_four_code": "1234",
    "address2": "Apt 1"
  }
}',
  'headers' => [
    'Authorization' => '<token>.',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.joincandidhealth.com/api/organization-service-facilities/v2/30F55EE6-8C0E-43FC-A7FC-DAC00D5BF569");
var request = new RestRequest(Method.PATCH);
request.AddHeader("Authorization", "<token>.");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"name\": \"Test Service Facility\",\n  \"aliases\": [\n    \"Test Service Facility Alias\"\n  ],\n  \"description\": \"Test Service Facility Description\",\n  \"status\": \"active\",\n  \"operational_status\": \"C\",\n  \"mode\": \"instance\",\n  \"type\": \"DX\",\n  \"physical_type\": \"si\",\n  \"telecoms\": [\n    \"555-555-5555\"\n  ],\n  \"address\": {\n    \"address1\": \"123 Main St\",\n    \"city\": \"New York\",\n    \"state\": \"NY\",\n    \"zip_code\": \"10001\",\n    \"zip_plus_four_code\": \"1234\",\n    \"address2\": \"Apt 1\"\n  }\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "Authorization": "<token>.",
  "Content-Type": "application/json"
]
let parameters = [
  "name": "Test Service Facility",
  "aliases": ["Test Service Facility Alias"],
  "description": "Test Service Facility Description",
  "status": "active",
  "operational_status": "C",
  "mode": "instance",
  "type": "DX",
  "physical_type": "si",
  "telecoms": ["555-555-5555"],
  "address": [
    "address1": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zip_code": "10001",
    "zip_plus_four_code": "1234",
    "address2": "Apt 1"
  ]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.joincandidhealth.com/api/organization-service-facilities/v2/30F55EE6-8C0E-43FC-A7FC-DAC00D5BF569")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "PATCH"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```