PATCH
/
organizations
/
{organization_id}
Update Org
curl --request PATCH \
  --url https://dev.intermezzo.ai/organizations/{organization_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "validate_legal_name_against_blacklist": true,
  "legal_name": "<string>",
  "registration_country": "DE",
  "address": "<string>",
  "correspondence_address": "<string>",
  "dba_name": "<string>",
  "incorporation_date": "2023-12-25",
  "website": "<string>",
  "external_ref": "<string>"
}
'
import requests

url = "https://dev.intermezzo.ai/organizations/{organization_id}"

payload = {
    "validate_legal_name_against_blacklist": True,
    "legal_name": "<string>",
    "registration_country": "DE",
    "address": "<string>",
    "correspondence_address": "<string>",
    "dba_name": "<string>",
    "incorporation_date": "2023-12-25",
    "website": "<string>",
    "external_ref": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    validate_legal_name_against_blacklist: true,
    legal_name: '<string>',
    registration_country: 'DE',
    address: '<string>',
    correspondence_address: '<string>',
    dba_name: '<string>',
    incorporation_date: '2023-12-25',
    website: '<string>',
    external_ref: '<string>'
  })
};

fetch('https://dev.intermezzo.ai/organizations/{organization_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dev.intermezzo.ai/organizations/{organization_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'validate_legal_name_against_blacklist' => true,
    'legal_name' => '<string>',
    'registration_country' => 'DE',
    'address' => '<string>',
    'correspondence_address' => '<string>',
    'dba_name' => '<string>',
    'incorporation_date' => '2023-12-25',
    'website' => '<string>',
    'external_ref' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

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

func main() {

	url := "https://dev.intermezzo.ai/organizations/{organization_id}"

	payload := strings.NewReader("{\n  \"validate_legal_name_against_blacklist\": true,\n  \"legal_name\": \"<string>\",\n  \"registration_country\": \"DE\",\n  \"address\": \"<string>\",\n  \"correspondence_address\": \"<string>\",\n  \"dba_name\": \"<string>\",\n  \"incorporation_date\": \"2023-12-25\",\n  \"website\": \"<string>\",\n  \"external_ref\": \"<string>\"\n}")

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

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

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

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

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.patch("https://dev.intermezzo.ai/organizations/{organization_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"validate_legal_name_against_blacklist\": true,\n  \"legal_name\": \"<string>\",\n  \"registration_country\": \"DE\",\n  \"address\": \"<string>\",\n  \"correspondence_address\": \"<string>\",\n  \"dba_name\": \"<string>\",\n  \"incorporation_date\": \"2023-12-25\",\n  \"website\": \"<string>\",\n  \"external_ref\": \"<string>\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://dev.intermezzo.ai/organizations/{organization_id}")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"validate_legal_name_against_blacklist\": true,\n  \"legal_name\": \"<string>\",\n  \"registration_country\": \"DE\",\n  \"address\": \"<string>\",\n  \"correspondence_address\": \"<string>\",\n  \"dba_name\": \"<string>\",\n  \"incorporation_date\": \"2023-12-25\",\n  \"website\": \"<string>\",\n  \"external_ref\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body
{
  "legal_name": "<string>",
  "address": {
    "id": "<string>",
    "address": "<string>",
    "components": {
      "formatted_address": "<string>",
      "street_number": "<string>",
      "road": "<string>",
      "city": "<string>",
      "state": "<string>",
      "country": "<string>",
      "postal_code": "<string>",
      "postal_code_suffix": "<string>",
      "latitude": 123,
      "longitude": 123
    },
    "content": {
      "normalized_address": "<string>",
      "country_code": "DE",
      "address_type": "HAUSANSCHRIFT"
    }
  },
  "id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "work_sites": [
    {
      "name": "<string>",
      "address": {
        "id": "<string>",
        "address": "<string>",
        "components": {
          "formatted_address": "<string>",
          "street_number": "<string>",
          "road": "<string>",
          "city": "<string>",
          "state": "<string>",
          "country": "<string>",
          "postal_code": "<string>",
          "postal_code_suffix": "<string>",
          "latitude": 123,
          "longitude": 123
        },
        "content": {
          "normalized_address": "<string>",
          "country_code": "DE",
          "address_type": "HAUSANSCHRIFT"
        }
      },
      "is_active": true,
      "is_primary": true,
      "id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "correspondence_address": {
        "id": "<string>",
        "address": "<string>",
        "components": {
          "formatted_address": "<string>",
          "street_number": "<string>",
          "road": "<string>",
          "city": "<string>",
          "state": "<string>",
          "country": "<string>",
          "postal_code": "<string>",
          "postal_code_suffix": "<string>",
          "latitude": 123,
          "longitude": 123
        },
        "content": {
          "normalized_address": "<string>",
          "country_code": "DE",
          "address_type": "HAUSANSCHRIFT"
        }
      },
      "valid_from": "2023-12-25",
      "valid_to": "2023-12-25",
      "org_id": "<string>",
      "contacts": [
        {
          "name": "<string>",
          "id": "<string>",
          "email": "jsmith@example.com",
          "phone": {
            "phone_number": "<string>"
          },
          "roles": []
        }
      ],
      "tax_identifiers": {
        "id": 123,
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25",
        "tax_data": {
          "country": "<string>",
          "valid_from": "2023-12-25",
          "valid_to": "2023-12-25",
          "tax_number": "<string>",
          "is_employee_flat_tax": false,
          "is_employee_mini_job_flat_tax": false
        }
      },
      "insurance_data": {
        "id": 123,
        "valid_from": "2023-12-25",
        "valid_to": "2023-12-25",
        "insurance_country": "DE",
        "worksite_location_number": "98797889",
        "accident_insurance_company_number": "98797889",
        "accident_insurance_pin": "DE-WS-PIN-456",
        "payroll_service_provider_number": "98797889",
        "payroll_processing_location_number": "98797889"
      }
    }
  ],
  "bank_accounts": [
    {
      "financial_institution_name": "<string>",
      "id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "account_number": "DE: DE89370400440532013000",
      "routing_number": "DE: 370400440",
      "iban": "DE: DE89370400440532013000",
      "swift_code": "DE: COBADEFFXXX",
      "account_details": {},
      "is_active": true,
      "is_primary": false
    }
  ],
  "preferences": {
    "id": 123,
    "valid_from": "2023-12-25",
    "valid_to": "2023-12-25",
    "is_insolvent": false,
    "insolvency_start_date": "2023-12-25",
    "insolvency_end_date": "2023-12-25",
    "insolvency_company_number": "<string>",
    "extra_paid_leave_days": 123,
    "first_payroll_date": "2023-12-25",
    "last_payroll_date": "2023-12-25",
    "first_payroll_intermezzo": "2023-12-25",
    "logo_id": "<string>",
    "preferences_country": "DE",
    "insurance_credit_preference": "<string>",
    "days_for_sickness_certificate": 4
  },
  "correspondence_address": {
    "id": "<string>",
    "address": "<string>",
    "components": {
      "formatted_address": "<string>",
      "street_number": "<string>",
      "road": "<string>",
      "city": "<string>",
      "state": "<string>",
      "country": "<string>",
      "postal_code": "<string>",
      "postal_code_suffix": "<string>",
      "latitude": 123,
      "longitude": 123
    },
    "content": {
      "normalized_address": "<string>",
      "country_code": "DE",
      "address_type": "HAUSANSCHRIFT"
    }
  },
  "dba_name": "<string>",
  "incorporation_date": "2023-12-25",
  "website": "<string>",
  "external_ref": "<string>",
  "valid_from": "2023-12-25",
  "valid_to": "2023-12-25",
  "shutdown_date": "2023-12-25",
  "contacts": [
    {
      "name": "<string>",
      "id": "<string>",
      "email": "jsmith@example.com",
      "phone": {
        "phone_number": "<string>"
      },
      "roles": []
    }
  ],
  "tax_identifiers": {
    "id": 123,
    "valid_from": "2023-12-25",
    "valid_to": "2023-12-25",
    "tax_data": {
      "country": "<string>",
      "valid_from": "2023-12-25",
      "valid_to": "2023-12-25",
      "tax_number": "<string>",
      "is_employee_flat_tax": false,
      "is_employee_mini_job_flat_tax": false
    }
  },
  "insurance_data": {
    "id": 123,
    "valid_from": "2023-12-25",
    "valid_to": "2023-12-25",
    "insurance_country": "DE",
    "company_number": "98797889",
    "unrs": "DE987654321",
    "accident_insurance_company_number": "98797889",
    "accident_insurance_pin": "12345",
    "payroll_service_provider_number": "98797889",
    "payroll_processing_location_number": "98797889",
    "u1_selected": false,
    "u2_selected": false,
    "u3_selected": false,
    "agency_id": "<string>",
    "alternate_agency_id": "<string>",
    "contact_id": "<string>"
  },
  "sepa_mandates": [
    {
      "creditor_id": "<string>",
      "bank_account_id": "<string>",
      "is_recurring": true,
      "id": "<string>",
      "created_by": "<string>",
      "valid_from": "2023-12-25",
      "valid_to": "2023-12-25",
      "mandate_reference": "<string>"
    }
  ]
}
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Get token from Auth0 and paste it here

Path Parameters

​
organization_id
required

Body

application/json
​
validate_legal_name_against_blacklist
boolean
default:true

Whether or not the legal name should be checked for terms on blacklist

​
legal_name
string | null
​
registration_country
string
default:DE
Allowed value: "DE"
​
address
​
correspondence_address
​
dba_name
string | null
​
incorporation_date
string<date> | null
​
website
string | null
​
external_ref
string | null

Response

Successful Response

​
registration_country
enum<string>
required

Enum for CountryAlpha2 codes

Available options:
DE,
IE,
GB,
US,
GB
​
legal_name
string
required
​
address
AddressResponse · object
required
​
id
string
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
work_sites
WorksiteResponse · object[] | null
required
​
bank_accounts
BankAccountResponse · object[] | null
required
​
preferences
DEOrganizationPreferencesResponse · object
required
​
correspondence_address
AddressResponse · object | null
​
dba_name
string | null
​
incorporation_date
string<date> | null
​
website
string | null
​
external_ref
string | null
Maximum string length: 255
​
valid_from
string<date> | null
​
valid_to
string<date> | null
​
shutdown_date
string<date> | null
​
contacts
ContactResponse · object[] | null
​
tax_identifiers
TaxIdentifiersResponse · object | null
​
insurance_data
DEOrganizationInsuranceDetailsResponse · object
​
sepa_mandates
SepaMandateResponse · object[]