MOmonta
Tax Compliance

Register a team's FR tax compliance

Changed on

Sets the FR fiscal registration, and optionally the compliance identifiers, on an existing team. countryCode must be fr (the only country supported today). The fiscal registration, including its declaration, is required; the compliance identifiers are optional. Idempotent upsert. The team's address is then replaced with the address held for the company in the French business registry, looked up by FR_SIRET when the team has one on record and by FR_SIREN otherwise, so the team carries its registered address rather than the one it was created with. Only the street, postcode and city the registry answers with are replaced; anything it leaves empty keeps its current value, and a company that has opted out of public diffusion of its registry data keeps its address unchanged. Registering the compliance data succeeds even if the registry cannot be reached — repeat the call to apply the address. Required scope: teams:write </br>Organization authorization: supported

put/api/v1/teams/{teamId}/tax-compliance/{countryCode}

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/teams/{teamId}/tax-compliance/{countryCode}
  • Auth
    HTTP bearer

Path parameters

teamIdinteger required
countryCodestring required

Request body

compliance_identifiersobject nullable

The company's official French registration numbers, given as key/value pairs where each key names a type of identifier and the value is the number itself. You do not need to send all three — always include FR_SIREN, and add the others only if they apply:

  • FR_SIREN — required. The 9-digit number that identifies the company nationally.
  • FR_SIRET — optional. The 14-digit number that identifies one specific site of the company (its SIREN followed by a 5-digit site code). Include it when registering a particular establishment.
  • FR_VAT — optional. The company's French VAT number. It is derived from the SIREN/SIRET, so you normally don't need to set it yourself.

Example request

{
  "compliance_identifiers": {
    "FR_SIREN": "840227060",
    "FR_SIRET": "84022706000012",
    "FR_VAT": "FR00840227060"
  },
  "fiscal_registration": {
    "vatPaymentBasis": "ENCAISSEMENTS",
    "legalFormCode": "5710",
    "vatExemptionReasonCode": "VATEX-FR-FRANCHISE",
    "routingIdentifier": "840227060_SERVICEACHATS",
    "declaration": {
      "issuanceScope": "IN_SCOPE_2026"
    }
  }
}

Response

Compliance data registered

Changes

  • 0ca400461c52Revision changes
    • breaking

      the request property became required

    • breaking

      the request property ///// became required

    • breaking

      the request property ////////// became required

    • breaking

      the / request property type changed from object to string

    • info

      added the new optional request property /////