Creating a company
Create a company
Use the POST /company endpoint to create a company:
NOTE
If you are a non-IOBSP partner, please refer to this section: Non-IOBSP Partner
Payload JSON
json
{
"user": {
"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",
"contact": {
"email": "jeandupont@test.com",
"phone": "+33700000000",
"lang": "fr"
}
},
"legal-form": "fra_ei",
"country": "fra",
"legal-id": "83431567300014",
"legal-name": "iliad78",
"date-registration": "2017-06-12",
"url": "https://stancer.com/fr/",
"headquarters-address": {
"city": "Paris",
"country": "fra",
"line1": "14 rue",
"zip-code": "75008"
},
"iban": "FR1420041010050500013M02606",
"services": [{
"type": "physical"
}, {
"type": "online"
}],
"activity-reference": "49.32Z",
"average-basket": "50_100",
"forecast-turnover": "20000_200000",
"pnfe": true,
"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
}],
"representatives": [{
"transaction-identifier": "jean-id",
"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"
},
"position": "ei_gerant"
}]
}python
import requests
import json
url = "https://api-partners.stancer.com/api/partners/company"
payload = json.dumps({
"user": {
"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",
"contact": {
"email": "jeandupont@test.com",
"phone": "+33700000000",
"lang": "fr"
}
},
"legal-form": "fra_ei",
"country": "fra",
"legal-id": "83431567300014",
"legal-name": "iliad78",
"date-registration": "2017-06-12",
"url": "https://stancer.com/fr/",
"headquarters-address": {
"city": "Paris",
"country": "fra",
"line1": "14 rue",
"zip-code": "75008"
},
"iban": "FR1420041010050500013M02606",
"services": [
{
"type": "physical"
},
{
"type": "online"
}
],
"activity-reference": "49.32Z",
"average-basket": "50_100",
"forecast-turnover": "20000_200000",
"pnfe": True,
"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
}
],
"representatives": [
{
"transaction-identifier": "jean-id",
"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"
},
"position": "ei_gerant"
}
]
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.json())Response :
json
{
"company": {
"accounts": [
{
"created": "2024-06-11",
"id": "acct_R9BEsSrXBF3WaS5RiAqy7r5x",
"name": "iliad78"
}
],
"activity-reference": "49.32Z",
"average-basket": {
"code": "50_100",
"maximum": 100,
"minimum": 50
},
"contact": {
"email": "jeandupont@test.com",
"lang": "fr",
"name": "Jean Dupont",
"phone": "+33665000000"
},
"country": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"date-registration": "2017-06-12",
"documents": [],
"enabled-services": [
{
"type": "physical"
},
{
"type": "online"
}
],
"forecast-turnover": {
"code": "20000_200000",
"maximum": 200000,
"minimum": 20000
},
"headquarters-address": {
"business-name": "iliad78",
"city": "Paris",
"country": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"id": "addr_5en6NlXXQXcKZsCLdmcTA771",
"line1": "14 rue",
"zip-code": "75008"
},
"iban": "FR1420041010050500013M02606",
"id": "comp_pQ2rLuQrMUwufhyqbzYXe58D",
"legal-form": {
"code": "fra_ei",
"description": "Entreprise individuelle",
"has-legal-status": false,
"label": "EI"
},
"legal-id": "83431567300014",
"legal-name": "iliad78",
"mcc": {
"code": 4121,
"name": "Taxicabs and Limousines"
},
"owners": [
{
"capital": 1.0,
"control": true,
"documents": [],
"person": {
"address": {
"city": "Paris",
"country": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"id": "addr_y2AcQedeOvrjR7gkklbG408h",
"line1": "10 rue",
"zip-code": "75008"
},
"birth": {
"country": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"date": "1991-01-28",
"department": "75017",
"place": "Paris"
},
"contact": {
"email": "jeandupont@test.com",
"lang": "fr",
"name": "Jean Dupont",
"phone": "+33665000000"
},
"country-residence": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"first-name": "Jean",
"id": "pers_ixk24J12a8xEk4IirtGb3HQn",
"last-name": "Dupont",
"nationality": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
}
},
"transaction-identifier": "jean-id",
"votes": 1.0
}
],
"pnfe": true,
"representatives": [
{
"documents": [],
"person": {
"address": {
"city": "Paris",
"country": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"id": "addr_y2AcQedeOvrjR7gkklbG408h",
"line1": "10 rue",
"zip-code": "75008"
},
"birth": {
"country": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"date": "1991-01-28",
"department": "75017",
"place": "Paris"
},
"contact": {
"email": "jeandupont@test.com",
"lang": "fr",
"name": "Jean Dupont",
"phone": "+33665000000"
},
"country-residence": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"first-name": "Jean",
"id": "pers_ixk24J12a8xEk4IirtGb3HQn",
"last-name": "Dupont",
"nationality": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
}
},
"position": {
"code": "ei_gerant",
"name": "Gérant"
},
"transaction-identifier": "jean-id"
}
],
"status": "notComplete",
"trade-name": "iliad78",
"url": "https://stancer.com/fr/"
},
"documents-to-upload": {
"company-documents": [
{
"document": "kbis",
"upload-url": "https://api-partners.stancer.com/api/partners/document/HdgTAvnducNbK7PqJPw7se5kqx3Yrw"
},
{
"document": "iban",
"upload-url": "https://api-partners.stancer.com/api/partners/document/7JQnjfKHDnfsr0MRwEAcddB3glWj7q"
}
],
"identity-documents": [
{
"address": "10 rue",
"city": "Paris",
"country": "fra",
"date-birth": "1991-01-28",
"first-name": "Jean",
"id": "pers_ixk24J12a8xEk4IirtGb3HQn",
"last-name": "Dupont",
"transaction-identifier": "jean-id",
"upload-url": "https://api-partners.stancer.com/api/partners/document/l2QGgbXIKjldpMlCTcLsNigd41tCsF",
"zip-code": "75008"
}
]
},
"user": {
"contact": {
"email": "jeandupont@test.com",
"lang": "fr",
"name": "Jean Dupont",
"phone": "+33665000000"
},
"first-name": "Jean",
"id": "user_djHrB1OsphVuOhkOF3gyAX9N",
"last-name": "Dupont",
"person": {
"address": {
"city": "Paris",
"country": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"id": "addr_y2AcQedeOvrjR7gkklbG408h",
"line1": "10 rue",
"zip-code": "75008"
},
"birth": {
"country": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"date": "1991-01-28",
"department": "75017",
"place": "Paris"
},
"contact": {
"email": "jeandupont@test.com",
"lang": "fr",
"name": "Jean Dupont",
"phone": "+33665000000"
},
"country-residence": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"first-name": "Jean",
"id": "pers_ixk24J12a8xEk4IirtGb3HQn",
"last-name": "Dupont",
"nationality": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
}
},
"username": "jeandupont@test.com"
}
}You will need to run some queries beforehand to populate certain fields, such as:
activity-referenceaverage-basket(optional)field-of-activity(optional)forecast-turnover(optional)country/country-residence/nationalitylanglegal-formservices(optional)
Non-IOBSP Partner
If you are a non-IOBSP partner, not all fields are required to create a company.
Here are the minimum requirements:
Payload JSON
json
{
"user": {
"first-name": "Jean",
"last-name": "Dupont",
"contact": {
"email": "jeandupont@test.com",
"phone": "+33665000000",
"lang": "fr"
}
},
"country": "fra",
"legal-name": "iliad78"
}python
import requests
import json
url = "https://api-partners.stancer.com/api/partners/company"
payload = json.dumps({
"user": {
"first-name": "Jean",
"last-name": "Dupont",
"contact": {
"email": "jeandupont@test.com",
"phone": "+33665000000",
"lang": "fr"
}
},
"country": "fra",
"legal-name": "iliad78"
})
headers = {
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.json())Response :
json
{
"company": {
"accounts": [
{
"created": "2026-04-21",
"id": "acct_Q1hfvHzM00FDLWyCqTyZY07r",
"name": "iliad78"
}
],
"contact": {
"email": "jeandupont@test.com",
"lang": "fr",
"name": "Jean Dupont",
"phone": "+33665000000"
},
"country": {
"alpha2": "fr",
"alpha3": "fra",
"name": "France",
"numeric": 250
},
"documents": [],
"iban": "",
"id": "comp_HBPtPkwns09Bmc3A0vCnWldn",
"legal-name": "iliad78",
"owners": [],
"pnfe": false,
"representatives": [],
"status": "notComplete",
"trade-name": "iliad78"
},
"documents-to-upload": {
"company-documents": [],
"identity-documents": []
},
"user": {
"contact": {
"email": "jeandupont@test.com",
"lang": "fr",
"name": "Jean Dupont",
"phone": "+33665000000"
},
"first-name": "Jean",
"id": "user_U0voIDC0ugabk52s4WQk2n5y",
"last-name": "Dupont",
"person": {
"birth": {},
"contact": {
"email": "jeandupont@test.com",
"lang": "fr",
"name": "Jean Dupont",
"phone": "+33665000000"
},
"first-name": "Jean",
"id": "pers_Cds0nIiJUIT63RUgbiQbLeAe",
"last-name": "Dupont"
},
"username": "jeandupont@test.com"
}
}You can then access the link to complete your registration.
activity-reference (NAF/APE code)
Use the GET /naf-code endpoint if you want to retrieve the NAF codes accepted by Stancer.
The NAF code you provide allows us to retrieve the company’s mcc.
The mcc is returned for informational purposes only.
Average-basket
Use the GET /average-basket?currency=<alpha3> endpoint to retrieve the average cart value:
python
import requests
url = "https://api-partners.stancer.com/api/partners/average-basket?currency=eur"
payload = {}
headers = {}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.json())You can use the GET /currency endpoint to retrieve the alpha3 code for available currencies.
Field-of-activity
Use the GET /field-of-activity endpoint to retrieve the field-of-activity code.
Forecast-turnover
Use the GET /forecast-turnover?currency=<alpha3> endpoint to retrieve the forecast-turnover code.
Country / country-residence / nationality
Use the GET /countries?type=<type> endpoint to retrieve a country's alpha3 code:
<type>address: Country for addressesbirth: Country for places of birthlegal_form: Country available for legal formsnationality: Country for nationalities
Lang
Use the GET /language endpoint to view the available languages.
Legal-form
Use the GET /legal-form?country=<alpha3> endpoint to view the available legal forms:
python
import requests
url = "https://api-partners.stancer.com/api/partners/legal-form?country=fra"
payload = {}
headers = {}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.json())The has-legal-status property is provided for informational purposes only.
Services
Use the GET /service endpoint to view available services.
Legal-id (SIRET/SIREN)
The legal-id corresponds to the SIRET.
You can also enter the SIREN; it will be converted to SIRET by our API.
Email unavailable
The email address provided during company registration may be unavailable:
json
{
"user": {
...
"contact": {
"email": "jeandupont@test.com",
...
}
},
...
}You will receive an HTTP response code 409, with a message and a type:
- Email not available: the email address is already in use.
json
{
"message": "Email unavailable",
"type": "email-unavailable"
}- Email account terminated: The email account has been terminated by Stancer.
json
{
"message": "Email terminated",
"type": "email-terminated"
}Retrieving Company Information
Use the GET /company?id=<comp> endpoint to retrieve company information:
python
import requests
url = "https://api-partners.stancer.com/api/partners/company?id=comp_GcVLPgH7YYhi2ZgW5qLTzv09"
payload = {}
headers = {}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.json())Update a company
Use the PATCH /company?id=<comp> endpoint to update a company.