Bit Capital

The Bit Capital Developer Hub

Welcome to the Bit Capital developer hub. You'll find comprehensive guides and documentation to help you start working with the platform as quickly as possible, as well as support if you get stuck. Let's jump right in!

Guides

Company Data

The company registration data with authorities, required if the account type is corporate.

Example company data for a Bit Capital corporate account.

{
   "taxId": "29079725000107",
   "tradeName": "Bit Capital Ltda.",
   "openingDate": "2017-11-16T00:00:00.000Z",
   "stateRegistration": "164677191686",
   "legalName": "Bit Capital Ltda",
   "establishmentFormat": "LTDA",
   "revenue": "1000000.00",
   "partnerChanged": false,
   "legalNature": "2062",
   "legalStatus": "active",
   "activities": [
     {
       "isMain": true,
       "code": "62.04-0-00",
       "description": "Consultoria em tecnologia da informação"
     }
   ],
   "partners": [
     {
       "name": "RICARDO ROESSLE GUIMARAES FILHO",
       "gender": "M",
       "birthDate": "1995-08-02T00:00:00.000Z",
       "birthCountry": "Brasil",
       "taxId": "01234567890",
       "type": "personal",
       "profile": "owner",
       "isPep": false,
       "email": "[email protected]",
       "phones": [
         {
           "code": "11",
           "number": "987654321"
         }
       ],
       "addresses": [{
       "street": "Av Nove de Julho",
       "number": "4939",
       "neighborhood": "Jardim Paulista",
       "code": "01407100",
       "city": "São Paulo",
       "state": "SP",
       "country": "BR",
       "status": "own"
     }]
     }
   ]
 }

Properties

activities

activities: EconomicActivity[]

The economic activites described with authorities.

In Brazil it's reference by CNAE numbers. This is considered public data, you can get it in any CNPJ registration searching website.


establishmentFormat

establishmentFormat: EstablishmentFormat

The establishment format of this company with the local authorities. It defines the relationships, liabilities and responsibilities of its partners.


legalName

legalName: string

The full legal name of this company, registrated with the authorities.


legalNature

legalNature: string

The legal nature is a numeric code that represents the composition of the company in terms of partnerthip.

In Brazil, it's defined by the CONCLA - IBGE.

Usually, the code is related to the establishmentFormat for the company.

  • MEI - 2135
  • EI - 2135
  • EIRELLI - 2305 or 2313
  • LTDA - 2062
  • SA - 2046 or 2054
  • COOP - 2143 or 2330

For more information check the official and additional references below:


legalStatus

legalStatus: string

The legal status of the company, available: ACTIVE or INACTIVE.

default ACTIVE


openingDate

openingDate: Date

The date the company was formally opened with the authorities.

Format: ISO-8601


partnerChanged

partnerChanged: boolean

Self declaration stating true if the partners of the company changed in the last year.


partners

partners: CompanyPartner[]

The list of partners of the company being created.


revenue

revenue: number

The last anual revenue of the company, as reported with authorities.


Optional stateRegistration

stateRegistration? : string

The number code of the State Registration of this company with the regional authorities.

👍

Best practice

If the company doesn't has an stateRegistration (IE in Brazil) do not send this field in the payload.
Do not send null, none ou empty double quotes ""

For São Paulo state, for example, you can check at JUCESP (sp.gov.br).


tradeName

tradeName: string

The trade name used by this company.

Updated 11 months ago


Company Data


The company registration data with authorities, required if the account type is corporate.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.