Update a company UBO's application

curl --request PATCH \
  --url https://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId} \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "birthDate": "2000-01-01",
  "nationalId": "<string>",
  "countryOfIssue": "<string>",
  "email": "jsmith@example.com"
}
'

import requests

url = "https://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}"

payload = {
    "firstName": "<string>",
    "lastName": "<string>",
    "birthDate": "2000-01-01",
    "nationalId": "<string>",
    "countryOfIssue": "<string>",
    "email": "jsmith@example.com"
}
headers = {
    "Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: '<string>',
    lastName: '<string>',
    birthDate: '2000-01-01',
    nationalId: '<string>',
    countryOfIssue: '<string>',
    email: 'jsmith@example.com'
  })
};

fetch('https://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}', 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://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}",
  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([
    'firstName' => '<string>',
    'lastName' => '<string>',
    'birthDate' => '2000-01-01',
    'nationalId' => '<string>',
    'countryOfIssue' => '<string>',
    'email' => 'jsmith@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Api-Key: <api-key>",
    "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://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}"

	payload := strings.NewReader("{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"birthDate\": \"2000-01-01\",\n  \"nationalId\": \"<string>\",\n  \"countryOfIssue\": \"<string>\",\n  \"email\": \"jsmith@example.com\"\n}")

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

	req.Header.Add("Api-Key", "<api-key>")
	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://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}")
  .header("Api-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"birthDate\": \"2000-01-01\",\n  \"nationalId\": \"<string>\",\n  \"countryOfIssue\": \"<string>\",\n  \"email\": \"jsmith@example.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}")

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

request = Net::HTTP::Patch.new(url)
request["Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"birthDate\": \"2000-01-01\",\n  \"nationalId\": \"<string>\",\n  \"countryOfIssue\": \"<string>\",\n  \"email\": \"jsmith@example.com\"\n}"

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

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "address": {
    "line1": "<string>",
    "city": "<string>",
    "region": "<string>",
    "postalCode": "<string>",
    "countryCode": "<string>",
    "line2": "<string>",
    "country": "<string>"
  },
  "applicationStatus": "approved",
  "externalId": "<string>",
  "sourceKey": "<string>",
  "ultimateBeneficialOwners": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "applicationStatus": "approved",
      "applicationExternalVerificationLink": {
        "url": "<string>",
        "params": {
          "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "applicationCompletionLink": {
        "url": "<string>",
        "params": {
          "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "applicationReason": "<string>"
    }
  ],
  "applicationExternalVerificationLink": {
    "url": "<string>",
    "params": {
      "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  },
  "applicationCompletionLink": {
    "url": "<string>",
    "params": {
      "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  },
  "applicationReason": "<string>"
}

PATCH

issuing

applications

company

{companyId}

ubo

{uboId}

Update a company UBO's application

curl --request PATCH \
  --url https://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId} \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "birthDate": "2000-01-01",
  "nationalId": "<string>",
  "countryOfIssue": "<string>",
  "email": "jsmith@example.com"
}
'

import requests

url = "https://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}"

payload = {
    "firstName": "<string>",
    "lastName": "<string>",
    "birthDate": "2000-01-01",
    "nationalId": "<string>",
    "countryOfIssue": "<string>",
    "email": "jsmith@example.com"
}
headers = {
    "Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    firstName: '<string>',
    lastName: '<string>',
    birthDate: '2000-01-01',
    nationalId: '<string>',
    countryOfIssue: '<string>',
    email: 'jsmith@example.com'
  })
};

fetch('https://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}', 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://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}",
  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([
    'firstName' => '<string>',
    'lastName' => '<string>',
    'birthDate' => '2000-01-01',
    'nationalId' => '<string>',
    'countryOfIssue' => '<string>',
    'email' => 'jsmith@example.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Api-Key: <api-key>",
    "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://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}"

	payload := strings.NewReader("{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"birthDate\": \"2000-01-01\",\n  \"nationalId\": \"<string>\",\n  \"countryOfIssue\": \"<string>\",\n  \"email\": \"jsmith@example.com\"\n}")

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

	req.Header.Add("Api-Key", "<api-key>")
	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://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}")
  .header("Api-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"birthDate\": \"2000-01-01\",\n  \"nationalId\": \"<string>\",\n  \"countryOfIssue\": \"<string>\",\n  \"email\": \"jsmith@example.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-dev.rain.xyz/v1/issuing/applications/company/{companyId}/ubo/{uboId}")

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

request = Net::HTTP::Patch.new(url)
request["Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\",\n  \"birthDate\": \"2000-01-01\",\n  \"nationalId\": \"<string>\",\n  \"countryOfIssue\": \"<string>\",\n  \"email\": \"jsmith@example.com\"\n}"

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

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "address": {
    "line1": "<string>",
    "city": "<string>",
    "region": "<string>",
    "postalCode": "<string>",
    "countryCode": "<string>",
    "line2": "<string>",
    "country": "<string>"
  },
  "applicationStatus": "approved",
  "externalId": "<string>",
  "sourceKey": "<string>",
  "ultimateBeneficialOwners": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "applicationStatus": "approved",
      "applicationExternalVerificationLink": {
        "url": "<string>",
        "params": {
          "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "applicationCompletionLink": {
        "url": "<string>",
        "params": {
          "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "applicationReason": "<string>"
    }
  ],
  "applicationExternalVerificationLink": {
    "url": "<string>",
    "params": {
      "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  },
  "applicationCompletionLink": {
    "url": "<string>",
    "params": {
      "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  },
  "applicationReason": "<string>"
}

Authorizations

Api-Key

string

header

required

Path Parameters

companyId

string<uuid>

required

Id of the company whose application is being reapplied

uboId

string<uuid>

required

Id of the UBO whose application is being reapplied

Body

application/json

Update information for this company UBO

firstName

string

The UBO's first name

Maximum string length: 50

lastName

string

The UBO's last name

Maximum string length: 50

birthDate

string<date>

The UBO's birth date

Example:

"2000-01-01"

nationalId

string

The UBO's national id, 9-digit SSN if country of issue is US

countryOfIssue

string

The UBO's country of issue of their national id

Required string length: 2

string<email>

The UBO's email address

address

object

The UBO's address

Show child attributes

Response

Successful operation

string<uuid>

required

The company's unique identifier

name

string

required

The company's name on the Rain platform

address

object

required

The company's physical address

Show child attributes

applicationStatus

enum<string>

required

Available options:

approved,

pending,

needsInformation,

needsVerification,

manualReview,

denied,

locked,

canceled

externalId

string

An optional tenant-defined identifier for this company. Must be unique within the tenant.

Required string length: 1 - 255

sourceKey

string

The source key associated with the company's team

Required string length: 1 - 24

ultimateBeneficialOwners

object[]

The company's ultimate beneficial owners

Show child attributes

applicationExternalVerificationLink

object

deprecated

The link to the external verification page for the application

Show child attributes

applicationCompletionLink

object

The link to the completion page for the application

Show child attributes

applicationReason

string

The reason for the application status

Overview

Compliance

Cards

Payments

Webhooks

Webhook Events

Update a company UBO's application

Authorizations

Path Parameters

Body

Response