State registration generator and validator
Generate valid state registrations (inscrição estadual) to use in tests or check whether one is valid, in any state.
A São Paulo state registration is generated when the page opens. Choose the state, the quantity and the format, or click "Generate state registration" to create another one.
How it works
- The registration is generated on the server and is not stored anywhere.
- Each state has its own length, prefix and check digit calculation, and the generator follows each state's SINTEGRA specification.
- In São Paulo, the generator creates the 12-digit industry and commerce registration.
- The number is for testing only and does not belong to any real company.
- The latest generated values are listed below the button until you leave the page.
How to use the API
You can integrate the state registration generator into your app through our REST API.
Endpoint
GET /api/generators/state-registration
Query parameters
- state
- Required. The state abbreviation, such as "SP".
- quantity
- Optional. From 1 to 50. When set, the response has the "stateRegistrations" list instead of "stateRegistration".
- formatted
- Optional. "false" generates digits only. Default: "true".
curl example
curl "https://devtools.vmotta.dev/api/generators/state-registration?state=MG&quantity=2"
Response
{
"stateRegistrations": [
"062.307.904/0081",
"195.445.174/3240"
]
}Choose the state, enter the registration and click "Validate state registration" to find out whether it is valid.
How it works
- Validation runs on the server and nothing is stored.
- The length, prefix and check digits required by the chosen state are verified.
- The registration can be entered with or without punctuation.
- In São Paulo, only the industry and commerce registration is accepted; the rural producer one, which starts with P, is not.
- The result shows up right below the field.
How to use the API
You can integrate the state registration validator into your app through our REST API.
Endpoint
POST /api/validators/state-registration
Request body
- stateRegistration
- Required. The number, with or without punctuation.
- state
- Required. The state abbreviation, such as "SP".
curl example
curl -X POST https://devtools.vmotta.dev/api/validators/state-registration \
-H "Content-Type: application/json" \
-d '{"stateRegistration":"110.042.490.114","state":"SP"}'Example body
{
"stateRegistration": "110.042.490.114",
"state": "SP"
}Response
{
"isValid": true
}