Update entity informations

PATCH /companies/:companyID/entities/:entityID

Request

Path Parameters

entityID uuidrequired

application/json

Body

required

general

object

nullable

entryDateIntoRelationship

object

anyOf

MOD1
MOD2

string

originCustomerRelationship stringnullable

Possible values: [incomingCall, outgoingCall, affiliate, eContact, eContactTmp, businessCapital, boogeLeads, prospecting, portfolioBuyout, aktifPlusMeeting, ifbMeeting, recommendation, signatureClient, meetingTmp, meeting, socialNetwork, retiree, tradeShows, website, dinner, spontaneousSolicitation, internalFollowUp, guardianshipAssociation, relationship, prescriber, formerClient, other]

contactCustomerRelationship stringnullable

remoteOpening booleannullable

dateLastMeeting

object

anyOf

MOD1
MOD2

string

entryIntoRelationshipNote stringnullable

gender stringnullable

Possible values: [male, female]

Default value: male

name stringnullable

lastName stringnullable

firstName stringnullable

birthDate

object

anyOf

MOD1
MOD2

string

birthZipCode stringnullable

birthRegion stringnullable

birthCity stringnullable

birthCountry stringnullable

birthName stringnullable

deathDate

object

anyOf

MOD1
MOD2

string

familySituation stringnullable

Possible values: [none, inARelationship, civilUnion, remarried, pendingDivorce, single, deceased, widowed, married, freeUnion, domesticPartnership, divorced, cohabitation, separated]

marriageDate

object

anyOf

MOD1
MOD2

string

nationality stringnullable

matrimonialRegime stringnullable

studiesLevel stringnullable

Possible values: [none, certificate, highSchool, bachelor, master, doctorate]

occupation stringnullable

occupationWording stringnullable

retirementAge numbernullable

annualIncome

object

anyOf

MOD1
MOD2

string

dependentsNb numbernullable

heritageOrigin stringnullable

sectorOfActivity stringnullable

dateEntryRelationship

object

anyOf

MOD1
MOD2

string

idCard stringnullable

idNumber stringnullable

issueDate

object

anyOf

MOD1
MOD2

string

authority stringnullable

expirationDate

object

anyOf

MOD1
MOD2

string

idNIF stringnullable

idMIF stringnullable

taxResidence stringnullable

customerClassificationMIF stringnullable

classificationDate

object

anyOf

MOD1
MOD2

string

pep booleannullable

usPerson booleannullable

legalCapacity stringnullable

Possible values: [noMeasure, capable, protectedUnderGuardianship, protectedUnderCuratorship, underJudicialSafeguard, unemancipatedMinor, emancipatedMinor, underJudicialConstraint, underGuardianship, absentOrOtherCapableMajor, other, judicialSafeguard, guardianship, enhancedGuardianship, custody, futureProtectionMandate, adHocAdministrator, posthumousMandate, oldStateGuardianship, oldGuardianshipManagement, oldGuardianshipArt511, oldGuardianshipArt512, privateManagementCustody, familyEmpowermentRepresentation, legalAdministration, familyEmpowermentAssistance]

tag stringnullable

referencesType stringnullable

Possible values: [customer, oldCustomer, prospect, relation]

updated

object

anyOf

MOD1
MOD2

string

homeAdress stringnullable

complement stringnullable

postalCode stringnullable

note stringnullable

city stringnullable

secondaryNationality stringnullable

country stringnullable

professionalCategory stringnullable

professionalSubcategory

object

anyOf

MOD1
MOD2

string

Possible values: [SMALL_FARMERS, MEDIUM_FARMERS, LARGE_FARMERS, ARTISANS, SHOPKEEPERS_&_RELATED, BUSINESS_OWNERS_10_MORE_EMPLOYEES, SELF_EMPLOYED, LIBERAL_PROFESSIONS_&_RELATED, CIVIL_SERVICE_EXECUTIVES, TEACHERS_&_SCIENTIFIC_PROFESSIONS, SCHOOL_TEACHERS_INSTITUTORS_&_RELATED, INFORMATION_ARTS_&_ENTERTAINMENT_PROFESSIONS, ADMINISTRATIVE_&_COMMERCIAL_BUSINESS_EXECUTIVES, ENGINEERS_&_TECHNICAL_BUSINESS_EXECUTIVES, HEALTH_AND_SOCIAL_WORK_INTERMEDIATE_PROFESSIONS, CLERGY_RELIGIOUS, PUBLIC_SERVICE_ADMINISTRATIVE_INTERMEDIATE_PROFESSIONS, ADMINISTRATIVE_&_COMMERCIAL_INTERMEDIATE_PROFESSIONS_IN_BUSINESS, TECHNICIANS, FOREMEN_SUPERVISORS, PUBLIC_SERVICE_EMPLOYEES, POLICE_OFFICERS_AND_MILITARY, ADMINISTRATIVE_EMPLOYEES_IN_BUSINESS, SALES_EMPLOYEES, DIRECT_SERVICE_PERSONNAL_FOR_INDIVIDUALS, SKILLED_WORKERS, UNSKILLED_WORKERS, AGRICULTURAL_WORKERS, FORMER_EXPLOITANT_FARMERS, FORMER_ARTISANS_SHOPKEEPERS_BUSINESS_OWNERS, FORMER_EXECUTIVES, FORMER_INTERMEDIATE_PROFESSIONS, FORMER_EMPLOYEES, FORMER_WORKERS, INACTIVE_OR_RETIRED_WITHOUT_NOTABLE_PREVIOUS_PROFESSIONAL_AFFILIATION, UNEMPLOYED_NEVER_HAVING_WORKED, CONSCRIPTS, PUPILS_STUDENTS, VARIOUS_INDIVIDUALS_WITHOUT_PROFESSIONNAL_ACTIVITY_UNDER_60_YEARS_OLD, VARIOUS_INDIVIDUALS_WITHOUT_PROFESSIONNAL_ACTIVITY_60_YEARS_OLD_&_MORE, OTHERS]

string

Possible values: [EXPLOITANT_FARMERS, ARTISANS, SHOPKEEPERS_&_RELATED, BUSINESS_OWNERS_10_MORE_EMPLOYEES, LIBERAL_PROFESSIONS_&_RELATED, CIVIL_SERVICE_EXECUTIVES, TEACHERS_&_SCIENTIFIC_PROFESSIONS, INFORMATION_ARTS_&_ENTERTAINMENT_PROFESSIONS, BUSINESS_EXECUTIVES, FORMER_EXPLOITANT_FARMERS, FORMER_ARTISANS_SHOPKEEPERS_BUSINESS_OWNERS, FORMER_EXECUTIVES_&_INTERMEDIATE_PROFESSIONS, INTERMEDIATE_PROFESSIONS_IN_EDUCATION_HEALTH_PUBLIC_SERVICE_&_RELATED, ADMINISTRATIVE_&_COMMERCIAL_INTERMEDIATE_PROFESSIONS_IN_BUSINESS, TECHNICIANS, FOREMEN_SUPERVISORS, PUBLIC_SERVICE_EMPLOYEES, ADMINISTRATIVE_EMPLOYEES_IN_BUSINESS, SALES_EMPLOYEES, DIRECT_SERVICE_PERSONNAL_FOR_INDIVIDUALS, SKILLED_WORKERS, UNSKILLED_WORKERS, AGRICULTURAL_WORKERS, FORMER_EMPLOYEES_&_WORKERS, UNEMPLOYED_NEVER_HAVING_WORKED, VARIOUS_INACTIVE_INDIVIDUALS, CONSCRIPTS, PUPILS_STUDENTS, VARIOUS_INDIVIDUALS_WITHOUT_PROFESSIONNAL_ACTIVITY_UNDER_60_YEARS_OLD, VARIOUS_INDIVIDUALS_WITHOUT_PROFESSIONNAL_ACTIVITY_60_YEARS_OLD_&_MORE, RETIRED_UNSKILLED_WORKERS_OR_SERVICE_OR_SALES_EMPLOYEES, RETIRED_SKILLED_WORKERS_FARMERS_ARTISANS_SHOPKEEPERS_ADMINISTRATIVE_EMPLOYEES, RETIRED_INTERMEDIATE_PROFESSIONS_TEACHERS_TECHNICIANS_SUPERVISORS, RETIRED_EXECUTIVES_LIBERAL_PROFESSIONS_PROFESSORS_SCIENTISTS_OR_BUSINESS_OWNERS_10_MORE_EMPLOYEES, SELF_EMPLOYED, OTHERS]

employmentStability stringnullable

Possible values: [UNEMPLOYED_OR_TEMPORARY, CDD_OR_INTERIM, CDI_RECENT, CDI_ESTABLISHED, CDI_LONG_TERM_OR_PUBLIC_SERVICE]

experienceRange stringnullable

Possible values: [LESS_THAN_1_YEAR, 1_3_YEARS, 3_5_YEARS, 5_10_YEARS, MORE_THAN_10_YEARS]

currentPastProfession stringnullable

Possible values: [NO, YES_CURRENT_PROFESSION, YES_LAST_10_YEARS, YES_MORE_THAN_10_YEARS]

externalClientFileReference stringnullable

information

object

nullable

socialReason stringnullable

Possible values: non-empty

contact stringnullable

firstAddress stringnullable

secondAddress stringnullable

postalCode stringnullable

city stringnullable

country stringnullable

phone stringnullable

fax stringnullable

email emailnullable

Possible values: non-empty

website stringnullable

holdingId stringnullable

siren stringnullable

siret stringnullable

ape stringnullable

rcsNumber stringnullable

creationDate stringnullable

accountClosingDate

object

anyOf

MOD1
MOD2

string

legalEntityIdentifier stringnullable

listedCompany booleannullable

mifClientClassification stringnullable

regulatedActivity booleannullable

legalForm stringnullable

socialCapital numbernullable

headOfficeAddress stringnullable

complementAddress stringnullable

secondaryPhone stringnullable

secondaryEmail emailnullable

Possible values: non-empty

managers

object[]

nullable

Array [

managerID stringrequired

primary booleanrequired

]

seniorAdvisor stringnullable

secondaryAdvisor stringnullable

entryDateIntoRelationship stringnullable

originCustomerRelationship stringnullable

contactCustomerRelationship stringnullable

remoteOpening booleannullable

dateLastMeeting stringnullable

entryIntoRelationshipNote stringnullable

ownership numbernullable

valuation numbernullable

managers

object

nullable

lastNameFirstName string

function string

birthDate stringnullable

nationality string

personalAddress string

personalPhoneNumber string

personalEmailAddress email

Possible values: non-empty

shareholderInformation string

idCard string

idNumber string

nbManagers

object

nullable

lastNameFirstName string

function string

birthDate stringnullable

nationality string

personalAddress string

personalPhoneNumber string

personalEmailAddress email

Possible values: non-empty

shareholderInformation string

idCard string

idNumber string

bankAccounts

object

nullable

banks string

iban string

bankAccountNumbers string

bic string

activities

object

nullable

mainActivities string

secondaryActivities string

clients string

suppliers string

competitors string

revenue number

workforce string

Possible values: [0, 1-10, 11-50, 51-250, 251-1000, 1000+]

taxRegime string

description string

details

object

nullable

street stringnullable

zipCode stringnullable

city stringnullable

addressSupplement stringnullable

workStreet stringnullable

workZipCode stringnullable

workCity stringnullable

workAddressSupplement stringnullable

otherStreet stringnullable

otherZipCode stringnullable

otherCity stringnullable

otherAddressSupplement stringnullable

fiscalAddress stringnullable

fiscalAddressStreet stringnullable

fiscalAddressSupplement stringnullable

fiscalAddressZipCode stringnullable

fiscalAddressCity stringnullable

fiscalAddressCountry stringnullable

firstPhoneNumber stringnullable

secondPhoneNumber stringnullable

personalEmail emailnullable

Possible values: non-empty

otherEmail emailnullable

Possible values: non-empty

country stringnullable

otherCountry stringnullable

workCountry stringnullable

Responses

success - entity informations

application/json

Schema
Example (from schema)

Schema

id stringrequired

name stringrequired

created stringnullable

The date of creation of the customer

updated stringrequired

The date of the last update of the customer

general

object

nullable

entryDateIntoRelationship

object

anyOf

MOD1
MOD2

string

originCustomerRelationship stringnullable

contactCustomerRelationship stringnullable

remoteOpening booleannullable

dateLastMeeting

object

anyOf

MOD1
MOD2

string

entryIntoRelationshipNote stringnullable

gender stringnullable

Possible values: [male, female]

Default value: male

name stringnullable

lastName stringnullable

firstName stringnullable

birthDate

object

anyOf

MOD1
MOD2

string

birthZipCode stringnullable

birthRegion stringnullable

birthCity stringnullable

birthCountry stringnullable

birthName stringnullable

deathDate

object

anyOf

MOD1
MOD2

string

familySituation stringnullable

marriageDate

object

anyOf

MOD1
MOD2

string

nationality stringnullable

matrimonialRegime stringnullable

studiesLevel stringnullable

Possible values: [none, certificate, highSchool, bachelor, master, doctorate]

occupation stringnullable

occupationWording stringnullable

retirementAge numbernullable

annualIncome

object

anyOf

MOD1
MOD2

string

dependentsNb numbernullable

heritageOrigin stringnullable

sectorOfActivity stringnullable

dateEntryRelationship

object

anyOf

MOD1
MOD2

string

idCard stringnullable

idNumber stringnullable

issueDate

object

anyOf

MOD1
MOD2

string

authority stringnullable

expirationDate

object

anyOf

MOD1
MOD2

string

idNIF stringnullable

idMIF stringnullable

taxResidence stringnullable

customerClassificationMIF stringnullable

classificationDate

object

anyOf

MOD1
MOD2

string

pep booleannullable

usPerson booleannullable

legalCapacity stringnullable

tag stringnullable

referencesType stringnullable

Possible values: [customer, oldCustomer, prospect, relation]

updated

object

anyOf

MOD1
MOD2

string

homeAdress stringnullable

complement stringnullable

postalCode stringnullable

note stringnullable

city stringnullable

secondaryNationality stringnullable

country stringnullable

professionalCategory stringnullable

professionalSubcategory

object

anyOf

MOD1
MOD2

string

employmentStability stringnullable

Possible values: [UNEMPLOYED_OR_TEMPORARY, CDD_OR_INTERIM, CDI_RECENT, CDI_ESTABLISHED, CDI_LONG_TERM_OR_PUBLIC_SERVICE]

experienceRange stringnullable

Possible values: [LESS_THAN_1_YEAR, 1_3_YEARS, 3_5_YEARS, 5_10_YEARS, MORE_THAN_10_YEARS]

currentPastProfession stringnullable

Possible values: [NO, YES_CURRENT_PROFESSION, YES_LAST_10_YEARS, YES_MORE_THAN_10_YEARS]

externalClientFileReference stringnullable

information

object

nullable

socialReason stringnullable

Possible values: non-empty

contact stringnullable

firstAddress stringnullable

secondAddress stringnullable

postalCode stringnullable

city stringnullable

country stringnullable

phone stringnullable

fax stringnullable

email emailnullable

Possible values: non-empty

website stringnullable

holdingId stringnullable

siren stringnullable

siret stringnullable

ape stringnullable

rcsNumber stringnullable

creationDate stringnullable

accountClosingDate

object

anyOf

MOD1
MOD2

string

legalEntityIdentifier stringnullable

listedCompany booleannullable

mifClientClassification stringnullable

regulatedActivity booleannullable

legalForm stringnullable

socialCapital numbernullable

headOfficeAddress stringnullable

complementAddress stringnullable

secondaryPhone stringnullable

secondaryEmail emailnullable

Possible values: non-empty

managers

object[]

nullable

Array [

managerID stringrequired

primary booleanrequired

]

seniorAdvisor stringnullable

secondaryAdvisor stringnullable

entryDateIntoRelationship stringnullable

originCustomerRelationship stringnullable

contactCustomerRelationship stringnullable

remoteOpening booleannullable

dateLastMeeting stringnullable

entryIntoRelationshipNote stringnullable

ownership numbernullable

valuation numbernullable

managers

object

nullable

lastNameFirstName string

function string

birthDate stringnullable

nationality string

personalAddress string

personalPhoneNumber string

personalEmailAddress email

Possible values: non-empty

shareholderInformation string

idCard string

idNumber string

nbManagers

object

nullable

lastNameFirstName string

function string

birthDate stringnullable

nationality string

personalAddress string

personalPhoneNumber string

personalEmailAddress email

Possible values: non-empty

shareholderInformation string

idCard string

idNumber string

bankAccounts

object

nullable

banks string

iban string

bankAccountNumbers string

bic string

activities

object

nullable

mainActivities string

secondaryActivities string

clients string

suppliers string

competitors string

revenue number

workforce string

Possible values: [0, 1-10, 11-50, 51-250, 251-1000, 1000+]

taxRegime string

description string

details

object

nullable

street stringnullable

zipCode stringnullable

city stringnullable

addressSupplement stringnullable

workStreet stringnullable

workZipCode stringnullable

workCity stringnullable

workAddressSupplement stringnullable

otherStreet stringnullable

otherZipCode stringnullable

otherCity stringnullable

otherAddressSupplement stringnullable

fiscalAddress stringnullable

fiscalAddressStreet stringnullable

fiscalAddressSupplement stringnullable

fiscalAddressZipCode stringnullable

fiscalAddressCity stringnullable

fiscalAddressCountry stringnullable

firstPhoneNumber stringnullable

secondPhoneNumber stringnullable

personalEmail emailnullable

Possible values: non-empty

otherEmail emailnullable

Possible values: non-empty

country stringnullable

otherCountry stringnullable

workCountry stringnullable

type stringnullable

Possible values: [person, company]

providers

object

nullable

Provider IDs associated with the entity. This field contains a mapping where each key represents a provider name and the value is an array of provider-specific IDs for this entity. This data comes from the funnel.entities.provider_ids column.

property name*

string[]

nullable

Array [

string

]

archived stringnullable

The date when the entity was archived. Null when the entity is active.

{
  "id": "adfdfaca-48f0-4f3b-b30a-c6d97293090c",
  "name": "Jean dupont",
  "created": "2024-01-01T00:00:00.000Z",
  "updated": "2024-01-01T00:00:00.000Z",
  "general": {
    "entryDateIntoRelationship": "string",
    "originCustomerRelationship": "incomingCall",
    "contactCustomerRelationship": "string",
    "remoteOpening": true,
    "dateLastMeeting": "string",
    "entryIntoRelationshipNote": "string",
    "gender": "male",
    "name": "string",
    "lastName": "string",
    "firstName": "string",
    "birthDate": "string",
    "birthZipCode": "string",
    "birthRegion": "string",
    "birthCity": "string",
    "birthCountry": "string",
    "birthName": "string",
    "deathDate": "string",
    "familySituation": "none",
    "marriageDate": "string",
    "nationality": "string",
    "matrimonialRegime": "string",
    "studiesLevel": "none",
    "occupation": "string",
    "occupationWording": "string",
    "retirementAge": 0,
    "annualIncome": "string",
    "dependentsNb": 0,
    "heritageOrigin": "string",
    "sectorOfActivity": "string",
    "dateEntryRelationship": "string",
    "idCard": "string",
    "idNumber": "string",
    "issueDate": "string",
    "authority": "string",
    "expirationDate": "string",
    "idNIF": "string",
    "idMIF": "string",
    "taxResidence": "string",
    "customerClassificationMIF": "string",
    "classificationDate": "string",
    "pep": true,
    "usPerson": true,
    "legalCapacity": "noMeasure",
    "tag": "string",
    "referencesType": "customer",
    "updated": "string",
    "homeAdress": "string",
    "complement": "string",
    "postalCode": "string",
    "note": "string",
    "city": "string",
    "secondaryNationality": "string",
    "country": "string",
    "professionalCategory": "string",
    "professionalSubcategory": "SMALL_FARMERS",
    "employmentStability": "UNEMPLOYED_OR_TEMPORARY",
    "experienceRange": "LESS_THAN_1_YEAR",
    "currentPastProfession": "NO",
    "externalClientFileReference": "string",
    "information": {
      "socialReason": "string",
      "contact": "string",
      "firstAddress": "string",
      "secondAddress": "string",
      "postalCode": "string",
      "city": "string",
      "country": "string",
      "phone": "string",
      "fax": "string",
      "email": "user@example.com",
      "website": "string",
      "holdingId": "string",
      "siren": "string",
      "siret": "string",
      "ape": "string",
      "rcsNumber": "string",
      "creationDate": "string",
      "accountClosingDate": "string",
      "legalEntityIdentifier": "string",
      "listedCompany": true,
      "mifClientClassification": "string",
      "regulatedActivity": true,
      "legalForm": "string",
      "socialCapital": 0,
      "headOfficeAddress": "string",
      "complementAddress": "string",
      "secondaryPhone": "string",
      "secondaryEmail": "user@example.com",
      "managers": [
        {
          "managerID": "string",
          "primary": true
        }
      ],
      "seniorAdvisor": "string",
      "secondaryAdvisor": "string",
      "entryDateIntoRelationship": "string",
      "originCustomerRelationship": "incomingCall",
      "contactCustomerRelationship": "string",
      "remoteOpening": true,
      "dateLastMeeting": "string",
      "entryIntoRelationshipNote": "string",
      "ownership": 0,
      "valuation": 0
    },
    "managers": {
      "lastNameFirstName": "string",
      "function": "string",
      "birthDate": "string",
      "nationality": "string",
      "personalAddress": "string",
      "personalPhoneNumber": "string",
      "personalEmailAddress": "user@example.com",
      "shareholderInformation": "string",
      "idCard": "string",
      "idNumber": "string"
    },
    "nbManagers": {
      "lastNameFirstName": "string",
      "function": "string",
      "birthDate": "string",
      "nationality": "string",
      "personalAddress": "string",
      "personalPhoneNumber": "string",
      "personalEmailAddress": "user@example.com",
      "shareholderInformation": "string",
      "idCard": "string",
      "idNumber": "string"
    },
    "bankAccounts": {
      "banks": "string",
      "iban": "string",
      "bankAccountNumbers": "string",
      "bic": "string"
    },
    "activities": {
      "mainActivities": "string",
      "secondaryActivities": "string",
      "clients": "string",
      "suppliers": "string",
      "competitors": "string",
      "revenue": 0,
      "workforce": "0",
      "taxRegime": "string",
      "description": "string"
    }
  },
  "details": {
    "street": "string",
    "zipCode": "string",
    "city": "string",
    "addressSupplement": "string",
    "workStreet": "string",
    "workZipCode": "string",
    "workCity": "string",
    "workAddressSupplement": "string",
    "otherStreet": "string",
    "otherZipCode": "string",
    "otherCity": "string",
    "otherAddressSupplement": "string",
    "fiscalAddress": "string",
    "fiscalAddressStreet": "string",
    "fiscalAddressSupplement": "string",
    "fiscalAddressZipCode": "string",
    "fiscalAddressCity": "string",
    "fiscalAddressCountry": "string",
    "firstPhoneNumber": "string",
    "secondPhoneNumber": "string",
    "personalEmail": "user@example.com",
    "otherEmail": "user@example.com",
    "country": "string",
    "otherCountry": "string",
    "workCountry": "string"
  },
  "type": "person",
  "providers": {
    "provider1": [
      "id1",
      "id2"
    ],
    "provider2": [
      "id3"
    ]
  },
  "archived": "2024-01-01T00:00:00.000Z"
}

Update entity informations

/companies/:companyID/entities/:entityID

Request​

Path Parameters

Body

Responses​

Request

Responses