Add representatives

You can add representatives and beneficiaries using the POST /company endpoint.

You can also add or modify representatives and beneficiaries using the PATCH /company endpoint.

Representatives

A representative can be a natural or legal person.

Natural person

Fill in person for a natural person:

Payload JSON

{
  "representatives": [{
    "transaction-identifier": "Jeanne-id",
    "person": {
      "address": {
        "city": "Paris",
        "country": "fra",
        "line1": "11 rue",
        "zip-code": "75007"
      },
      "birth": {
        "country": "fra",
        "date": "1992-02-28",
        "department": "75018",
        "place": "Paris"
      },
      "country-residence": "fra",
      "first-name": "Jeanne",
      "last-name": "Doe",
      "nationality": "fra"
    },
    "position": "ei_gerant"
  }]
}

import requests
import json

url = "https://api-partners.stancer.com/api/partners/company?id=comp_pQ2rLuQrMUwufhyqbzYXe58D"

payload = json.dumps({
  "representatives": [
    {
      "transaction-identifier": "Jeanne-id",
      "person": {
        "address": {
          "city": "Paris",
          "country": "fra",
          "line1": "11 rue",
          "zip-code": "75007"
        },
        "birth": {
          "country": "fra",
          "date": "1992-02-28",
          "department": "75018",
          "place": "Paris"
        },
        "country-residence": "fra",
        "first-name": "Jeanne",
        "last-name": "Doe",
        "nationality": "fra"
      },
      "position": "ei_gerant"
    }
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.json())

Enter the representative's ID when you want to update it:

Payload JSON

{
  "representatives": [{
    "person": {
      "id": "pers_ixk24J12a8xEk4IirtGb3HQn",
      "last-name": "Dupont"
    }
  }]
}

import requests
import json

url = "https://api-partners.stancer.com/api/partners/company?id=comp_pQ2rLuQrMUwufhyqbzYXe58D"

payload = json.dumps({
  "representatives": [
    {
      "person": {
        "id": "pers_ixk24J12a8xEk4IirtGb3HQn",
        "last-name": "Dupont",
      },
    }
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.json())

Legal entity

Enter company for a legal entity:

Payload JSON

{
  "representatives": [{
    "company": {
      "legal-form": "fra_ei",
      "country": "fra",
      "legal-id": "34237633200082",
      "legal-name": "ILIAD",
      "headquarters-address": {
        "city": "Paris",
        "country": "fra",
        "line1": "54 rue",
        "zip-code": "75001"
      },
      "activity-reference": "49.32Z",
      "representatives": [{
        "person": {
          "address": {
            "city": "Paris",
            "country": "fra",
            "line1": "32 rue",
            "zip-code": "75007"
          },
          "birth": {
            "country": "fra",
            "date": "1993-09-28",
            "department": "75006",
            "place": "Paris"
          },
          "country-residence": "fra",
          "first-name": "John",
          "last-name": "Doe",
          "nationality": "fra"
        },
        "position": "ei_gerant"
      }]
    },
    "position": "ei_gerant"
  }]
}

import requests
import json

url = "https://api-partners.stancer.com/api/partners/company?id=comp_mNQDwnraMLmyWNZUXfvvVIgF"

payload = json.dumps({
  "representatives": [
    {
      "company": {
        "legal-form": "fra_ei",
        "country": "fra",
        "legal-id": "34237633200082",
        "legal-name": "ILIAD",
        "headquarters-address": {
          "city": "Paris",
          "country": "fra",
          "line1": "54 rue",
          "zip-code": "75001"
        },
        "activity-reference": "49.32Z",
        "representatives": [
          {
            "person": {
              "address": {
                "city": "Paris",
                "country": "fra",
                "line1": "32 rue",
                "zip-code": "75007"
              },
              "birth": {
                "country": "fra",
                "date": "1993-09-28",
                "department": "75006",
                "place": "Paris"
              },
              "country-residence": "fra",
              "first-name": "John",
              "last-name": "Doe",
              "nationality": "fra"
            },
            "position": "ei_gerant"
          }
        ]
      },
      "position": "ei_gerant"
    }
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.json())

A legal entity must be associated with at least one representative.

Position

Use the endpoint GET /legal-form-position?legal-form=<code> to retrieve the code for the possible legal forms based on the company's legal status:

import requests

url = "https://api-partners.stancer.com/api/partners/legal-form-position?legal-form=fra_ei"

payload = {}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.json())

Response :

[
    {
        "code": "ei_gerant",
        "name": "Gérant"
    }
]

Beneficiaries

A beneficiary is a natural person.

Payload JSON

{
  "owners": [{
    "person": {
      "address": {
        "city": "Paris",
        "country": "fra",
        "line1": "10 rue",
        "zip-code": "75008"
      },
      "birth": {
        "country": "fra",
        "date": "1991-01-28",
        "department": "75017",
        "place": "Paris"
      },
      "country-residence": "fra",
      "first-name": "Jean",
      "last-name": "Dupont",
      "nationality": "fra"
    },
    "capital": 1.0,
    "control": true,
    "votes": 1.0
  }]
}

import requests
import json

url = "https://api-partners.stancer.com/api/partners/company?id=comp_mNQDwnraMLmyWNZUXfvvVIgF"

payload = json.dumps({
  "owners": [
    {
      "person": {
        "address": {
          "city": "Paris",
          "country": "fra",
          "line1": "10 rue",
          "zip-code": "75008"
        },
        "birth": {
          "country": "fra",
          "date": "1991-01-28",
          "department": "75017",
          "place": "Paris"
        },
        "country-residence": "fra",
        "first-name": "Jean",
        "last-name": "Dupont",
        "nationality": "fra"
      },
      "capital": 1.0,
      "control": True,
      "votes": 1.0
    }
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.json())

capital and votes represent the beneficiary's percentage ownership of the company (0.0 = 0%, 1.0 = 100%).

control indicates whether the beneficiary has controlling power over the company.

transaction-identifier (optional)

An identifier that you specify to help you identify the representative or beneficiary you have created or updated.

It will be returned to you along with the representatives, beneficiaries, and identity documents objects.

Delete a representative or beneficiary

Use the endpoint DELETE /company-head?company=<comp>&id=<pers/comp>&type=<representative/owner> to delete a representative or beneficiary:

import requests

url = "https://api-partners.stancer.com/api/partners/company-head?company=comp_mNQDwnraMLmyWNZUXfvvVIgF&id=pers_LBhl5B2miYW2O95gGrw5G5pI&type=representative"

payload = {}
headers = {}

response = requests.request("DELETE", url, headers=headers, data=payload)

print(response.json())