Skip to main content
POST
/
clients
/
{parentClientId}
/
related
Create a related (non-primary) client and link it
curl --request POST \
  --url https://api.artu.ai/clients/{parentClientId}/related \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Environment: <api-key>' \
  --data '
{
  "child": {
    "type": "<unknown>",
    "name": "<string>",
    "scopes": [],
    "nationalities": "<string>",
    "externalId": "<string>",
    "metadata": {},
    "birthDate": "2023-12-25",
    "middleName": "<string>",
    "lastName": "<string>",
    "scopeData": {
      "MX": {
        "rfc": "<string>",
        "curp": "<string>",
        "actividadVulnerable": {
          "ARI": {},
          "AVI": {
            "username": "<string>"
          },
          "INM": {},
          "JYS": {},
          "MJR": {},
          "MPC": {},
          "TSC": {},
          "VEH": {}
        },
        "cnbv": {
          "TRANSMISOR": {
            "numeroCuenta": "<string>",
            "claveSujetoObligado": "<string>"
          }
        }
      },
      "US": "<unknown>"
    }
  },
  "metadata": {}
}
'
{
  "child": {
    "type": "<unknown>",
    "name": "<string>",
    "scopes": [],
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "isPrimary": true,
    "nationalities": "<unknown>",
    "externalId": "<string>",
    "metadata": {},
    "birthDate": "2023-12-25",
    "middleName": "<string>",
    "lastName": "<unknown>",
    "employment": {
      "isEmployee": true,
      "employeeId": "<string>",
      "position": "<string>",
      "department": "<string>",
      "startDate": "2023-12-25"
    },
    "scopeData": {
      "MX": {
        "rfc": "<string>",
        "curp": "<string>",
        "actividadVulnerable": {
          "ARI": {},
          "AVI": {
            "username": "<unknown>"
          },
          "INM": {},
          "JYS": {},
          "MJR": {},
          "MPC": {},
          "TSC": {},
          "VEH": {}
        },
        "cnbv": {
          "TRANSMISOR": {
            "numeroCuenta": "<string>",
            "claveSujetoObligado": "<string>"
          }
        }
      },
      "US": "<unknown>"
    },
    "email": "<string>",
    "phone": "<string>",
    "age": 0,
    "addresses": [
      {
        "clientId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "isPrimary": true,
        "street": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postalCode": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "type": "home",
        "country": "<unknown>",
        "externalId": "<string>",
        "metadata": {},
        "scopeData": {
          "MX": {
            "exteriorNumber": "<string>",
            "interiorNumber": "<string>",
            "neighborhood": "<string>",
            "municipality": "<string>",
            "betweenStreets": "<string>",
            "reference": "<string>",
            "cnbv": {
              "TRANSMISOR": {}
            }
          },
          "US": "<unknown>"
        }
      }
    ],
    "contactMethods": [
      {
        "clientId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "value": "<string>",
        "isVerified": true,
        "verifiedAt": "2023-11-07T05:31:56Z",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "isPrimary": false,
        "label": "<string>",
        "externalId": "<string>",
        "metadata": {}
      }
    ],
    "bankAccounts": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "clientId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "accountNumber": "<string>",
        "bankName": "<string>",
        "country": "<unknown>",
        "currency": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "bankCode": "<string>",
        "type": "checking",
        "isPrimary": true,
        "isActive": true,
        "label": "<string>",
        "externalId": "<string>",
        "metadata": {},
        "clabe": "<unknown>",
        "codigoBanco": "<string>",
        "codigoPlaza": "<string>"
      }
    ],
    "documents": [
      {
        "clientId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "type": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "status": "pending_upload",
        "filename": "<string>",
        "contentType": "<string>",
        "size": 0,
        "expiresAt": "2023-12-25",
        "verifiedAt": "2023-11-07T05:31:56Z",
        "verifiedBy": "<string>",
        "rejectionReason": "<string>",
        "reviewedAt": "2023-11-07T05:31:56Z",
        "reviewedBy": "<string>",
        "externalId": "<string>",
        "fields": {},
        "metadata": {}
      }
    ],
    "linkedClients": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "client": {
          "type": "<unknown>",
          "name": "<string>",
          "scopes": [],
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "nationalities": "<unknown>",
          "externalId": "<string>",
          "metadata": {},
          "birthDate": "2023-12-25",
          "middleName": "<string>",
          "lastName": "<unknown>",
          "employment": {
            "isEmployee": true,
            "employeeId": "<string>",
            "position": "<string>",
            "department": "<string>",
            "startDate": "2023-12-25"
          },
          "scopeData": {
            "MX": {
              "rfc": "<string>",
              "curp": "<string>",
              "actividadVulnerable": {
                "ARI": "<unknown>",
                "AVI": "<unknown>",
                "INM": "<unknown>",
                "JYS": "<unknown>",
                "MJR": "<unknown>",
                "MPC": "<unknown>",
                "TSC": "<unknown>",
                "VEH": "<unknown>"
              },
              "cnbv": {
                "TRANSMISOR": "<unknown>"
              }
            },
            "US": "<unknown>"
          }
        },
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "metadata": {}
      }
    ],
    "riskAssessments": {},
    "tags": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "color": "<string>"
      }
    ]
  },
  "link": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "client": {
      "type": "<unknown>",
      "name": "<string>",
      "scopes": [],
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "nationalities": "<unknown>",
      "externalId": "<string>",
      "metadata": {},
      "birthDate": "2023-12-25",
      "middleName": "<string>",
      "lastName": "<unknown>",
      "employment": {
        "isEmployee": true,
        "employeeId": "<string>",
        "position": "<string>",
        "department": "<string>",
        "startDate": "2023-12-25"
      },
      "scopeData": {
        "MX": {
          "rfc": "<string>",
          "curp": "<string>",
          "actividadVulnerable": {
            "ARI": {},
            "AVI": {
              "username": "<unknown>"
            },
            "INM": {},
            "JYS": {},
            "MJR": {},
            "MPC": {},
            "TSC": {},
            "VEH": {}
          },
          "cnbv": {
            "TRANSMISOR": {
              "numeroCuenta": "<string>",
              "claveSujetoObligado": "<string>"
            }
          }
        },
        "US": "<unknown>"
      }
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "metadata": {}
  },
  "parent": {
    "type": "<unknown>",
    "name": "<string>",
    "scopes": [],
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "isPrimary": true,
    "nationalities": "<unknown>",
    "externalId": "<string>",
    "metadata": {},
    "birthDate": "2023-12-25",
    "middleName": "<string>",
    "lastName": "<unknown>",
    "employment": {
      "isEmployee": true,
      "employeeId": "<string>",
      "position": "<string>",
      "department": "<string>",
      "startDate": "2023-12-25"
    },
    "scopeData": {
      "MX": {
        "rfc": "<string>",
        "curp": "<string>",
        "actividadVulnerable": {
          "ARI": {},
          "AVI": {
            "username": "<unknown>"
          },
          "INM": {},
          "JYS": {},
          "MJR": {},
          "MPC": {},
          "TSC": {},
          "VEH": {}
        },
        "cnbv": {
          "TRANSMISOR": {
            "numeroCuenta": "<string>",
            "claveSujetoObligado": "<string>"
          }
        }
      },
      "US": "<unknown>"
    },
    "email": "<string>",
    "phone": "<string>",
    "age": 0,
    "addresses": [
      {
        "clientId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "isPrimary": true,
        "street": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postalCode": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "type": "home",
        "country": "<unknown>",
        "externalId": "<string>",
        "metadata": {},
        "scopeData": {
          "MX": {
            "exteriorNumber": "<string>",
            "interiorNumber": "<string>",
            "neighborhood": "<string>",
            "municipality": "<string>",
            "betweenStreets": "<string>",
            "reference": "<string>",
            "cnbv": {
              "TRANSMISOR": {}
            }
          },
          "US": "<unknown>"
        }
      }
    ],
    "contactMethods": [
      {
        "clientId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "value": "<string>",
        "isVerified": true,
        "verifiedAt": "2023-11-07T05:31:56Z",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "isPrimary": false,
        "label": "<string>",
        "externalId": "<string>",
        "metadata": {}
      }
    ],
    "bankAccounts": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "clientId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "accountNumber": "<string>",
        "bankName": "<string>",
        "country": "<unknown>",
        "currency": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "bankCode": "<string>",
        "type": "checking",
        "isPrimary": true,
        "isActive": true,
        "label": "<string>",
        "externalId": "<string>",
        "metadata": {},
        "clabe": "<unknown>",
        "codigoBanco": "<string>",
        "codigoPlaza": "<string>"
      }
    ],
    "documents": [
      {
        "clientId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "type": "<string>",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "status": "pending_upload",
        "filename": "<string>",
        "contentType": "<string>",
        "size": 0,
        "expiresAt": "2023-12-25",
        "verifiedAt": "2023-11-07T05:31:56Z",
        "verifiedBy": "<string>",
        "rejectionReason": "<string>",
        "reviewedAt": "2023-11-07T05:31:56Z",
        "reviewedBy": "<string>",
        "externalId": "<string>",
        "fields": {},
        "metadata": {}
      }
    ],
    "linkedClients": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "client": {
          "type": "<unknown>",
          "name": "<string>",
          "scopes": [],
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "nationalities": "<unknown>",
          "externalId": "<string>",
          "metadata": {},
          "birthDate": "2023-12-25",
          "middleName": "<string>",
          "lastName": "<unknown>",
          "employment": {
            "isEmployee": true,
            "employeeId": "<string>",
            "position": "<string>",
            "department": "<string>",
            "startDate": "2023-12-25"
          },
          "scopeData": {
            "MX": {
              "rfc": "<string>",
              "curp": "<string>",
              "actividadVulnerable": {
                "ARI": "<unknown>",
                "AVI": "<unknown>",
                "INM": "<unknown>",
                "JYS": "<unknown>",
                "MJR": "<unknown>",
                "MPC": "<unknown>",
                "TSC": "<unknown>",
                "VEH": "<unknown>"
              },
              "cnbv": {
                "TRANSMISOR": "<unknown>"
              }
            },
            "US": "<unknown>"
          }
        },
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "metadata": {}
      }
    ],
    "riskAssessments": {},
    "tags": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "color": "<string>"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Obtain your API key from the dashboard.

​
X-Environment
string
header
required

Target environment for the request. Must be "test" or "live".

Path Parameters

​
parentClientId
string<uuid>
required

Body

application/json
​
relationshipType
enum<string>
required

Relationship Type

Available options:
legal_representative,
controlling_beneficiary
​
child
object
required
​
metadata
object

Metadata

Response

200 - application/json

OK

​
child
object
required
​
link
object
required
​
parent
object
required