GbdulInfoByBinV2 API 1.0.0

No votes yet

Description

Сервис для предоставления регистрационных данных о юридическом лице

Contact information

АО «Банк ЦентрКредит»

api@bcc.kz

Endpoints

production

development

https://api.bcc.kz:10443/bcc/production

Альтернативная точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"

production

https://api.bcc.kz/bcc/production

Точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"

development

https://api-test.bcc.kz/bcc/production

Точка подключения для вызова сервисов в тестовой среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "DEVELOPMENT"

Paths

/{bin}

Security

Authorization

(oauth2 application)

Токен аутентификации, полученный при вызове сервиса авторизации

Token URL

https://api.bcc.kz/bcc/production/v2/oauth/token

Scopes

bcc.application.govtech.api

Allow access to Goventment Services API

Parameters

bin

Required in path

string

БИН организации

Optional in header

string

application/json

Responses

200

200 OK

ResponseDto

400

400 Bad Request

FailureResponse

404

404 Not Found

FailureResponse

500

500 Internal Server Error

FailureResponse

Example Request

Example Response

Definition

GET https://api.bcc.kz:10443/bcc/production/gbdul-info-by-bin-v2/{bin}

Response

Try this operation

https://api.bcc.kz:10443/bcc/production/gbdul-info-by-bin-v2/{bin}

Headers

Parameters

bin

Request

Response

Definitions

FailureResponse

{
    "type": "object",
    "properties": {
        "timestamp": {
            "type": "string",
            "format": "date-time"
        },
        "error": {
            "type": "string"
        },
        "violations": {
            "type": "array",
            "items": {
                "$ref": "#\/definitions\/Violation"
            }
        }
    }
}

Violation

{
    "type": "object",
    "properties": {
        "name": {
            "type": "string"
        },
        "message": {
            "type": "string"
        }
    }
}

ResponseDto

{
    "title": "Ответ на запрос",
    "required": [
        "status"
    ],
    "type": "object",
    "properties": {
        "status": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "organization": {
            "$ref": "#\/definitions\/OrganizationTypeDto"
        },
        "ipsNerezident": {
            "$ref": "#\/definitions\/IpsNerezTypeDto"
        }
    }
}

DictionaryTypeDto

{
    "type": "object",
    "required": [
        "code",
        "nameKz",
        "nameRu"
    ],
    "properties": {
        "code": {
            "type": "string",
            "description": "Код",
            "example": "0"
        },
        "nameRu": {
            "type": "string",
            "description": "Значение на русском языке",
            "example": "Наименование на русском языке"
        },
        "nameKz": {
            "type": "string",
            "description": "Значение на государственном языке",
            "example": "Наименование на государственном языке"
        }
    }
}

OrganizationTypeDto

{
    "type": "object",
    "required": [
        "bin",
        "fullNameKz",
        "fullNameRu",
        "orgForm",
        "regStatus",
        "registrationDate",
        "registrationDepartment"
    ],
    "properties": {
        "bin": {
            "type": "string",
            "description": "БИН",
            "example": "010140017782"
        },
        "regStatus": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "registrationDepartment": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "registrationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Дата первичной регистрации",
            "example": "1999-08-25T00:00:00+06:00"
        },
        "registrationLastDate": {
            "type": "string",
            "format": "date-time",
            "description": "Дата последней перерегистрации",
            "example": "2001-08-25T00:00:00+06:00"
        },
        "liquidationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Дата ликвидации, реорганизации"
        },
        "fullNameRu": {
            "type": "string",
            "description": "Полное наименование на русском языке",
            "example": "Акционерное общество \"Информационно-учетный центр\""
        },
        "fullNameKz": {
            "type": "string",
            "description": "Полное наименование на государственном языке",
            "example": "\"Ақпараттық-есептеу орталығы\" акционерлік қоғамы"
        },
        "fullNameEn": {
            "type": "string",
            "description": "Полное наименование на английском языке"
        },
        "shortNameRu": {
            "type": "string",
            "description": "Сокращенное наименование на русском языке",
            "example": "АО \"Информационно-учетный центр\""
        },
        "shortNameKz": {
            "type": "string",
            "description": "Сокращенное наименование на государственном языке",
            "example": "\"Ақпараттық-есептеу орталығы\" АҚ"
        },
        "shortNameEn": {
            "type": "string",
            "description": "Сокращенное наименование на английском языке"
        },
        "orgForm": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "formOfLaw": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "privateEnterpriseType": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "taxOrgStatus": {
            "type": "boolean",
            "description": "1 - бездействующий,0-нет"
        },
        "addInfo": {
            "$ref": "#\/definitions\/AddInfoTypeDto"
        },
        "liquidation": {
            "$ref": "#\/definitions\/LiquidationTypeDto"
        },
        "organizationLeader": {
            "$ref": "#\/definitions\/LeaderTypeDto"
        },
        "activity": {
            "type": "array",
            "items": {
                "$ref": "#\/definitions\/ActivityTypeDto"
            },
            "description": "Виды деятельности"
        },
        "address": {
            "$ref": "#\/definitions\/AddressTypeDto"
        },
        "authCapital": {
            "$ref": "#\/definitions\/AuthCapitalTypeDto"
        },
        "foundersUL": {
            "type": "array",
            "items": {
                "$ref": "#\/definitions\/OrganizationShortTypeDto"
            },
            "description": "Участники, учредители - юрлица"
        },
        "foundersFL": {
            "type": "array",
            "items": {
                "$ref": "#\/definitions\/PersonTypeDto"
            },
            "description": "Участники, учредители - физлица"
        },
        "foundersCount": {
            "type": "integer",
            "format": "int32",
            "description": "Количество участников, учредителей",
            "example": 3
        },
        "foundersCountUL": {
            "type": "integer",
            "format": "int32",
            "description": "Количество участников, учредителей юридических лиц",
            "example": 1
        },
        "foundersCountFL": {
            "type": "integer",
            "format": "int32",
            "description": "Количество участников, учредителей физических лиц",
            "example": 2
        },
        "headerOrganization": {
            "$ref": "#\/definitions\/HeadTypeDto"
        },
        "statCommInfo": {
            "$ref": "#\/definitions\/StatCommInfoTypeDto"
        },
        "mainActivityProf": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "reorganizationBins": {
            "$ref": "#\/definitions\/ReorganizationTypeDto"
        },
        "benefiziars": {
            "$ref": "#\/definitions\/BenefiziarsTypeDto"
        }
    }
}

IpsNerezTypeDto

{
    "type": "object",
    "required": [
        "bin",
        "fullNameRu",
        "orgForm",
        "regDate",
        "regStatus"
    ],
    "properties": {
        "bin": {
            "type": "string",
            "description": "БИН"
        },
        "regDate": {
            "type": "string",
            "format": "date-time",
            "description": "Дата записи в Национальный реестр БИН"
        },
        "liquidationDate": {
            "type": "string",
            "format": "date-time",
            "description": "Дата прекращения деятельности"
        },
        "fullNameRu": {
            "type": "string",
            "description": "Полное наименование на русском языке"
        },
        "orgForm": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "countryFac": {
            "type": "boolean",
            "description": "CountryFac"
        },
        "countryNerezident": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "regStatus": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "leader": {
            "$ref": "#\/definitions\/LeaderIpsNerezTypeDto"
        },
        "address": {
            "$ref": "#\/definitions\/AddressIpsNerezTypeDto"
        }
    }
}

AddInfoTypeDto

{
    "type": "object",
    "required": [
        "creationMethod",
        "propertyType"
    ],
    "properties": {
        "creationMethod": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "propertyType": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "typicalCharter": {
            "type": "boolean",
            "description": "1 - деятельность по типовому уставу"
        },
        "commerceOrg": {
            "type": "boolean",
            "description": "1 - коммерческая организация"
        },
        "enterpriseSubject": {
            "type": "boolean",
            "description": "1 - субъект предпринимательства"
        },
        "fundType": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "gosCompanyType": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "statusOO": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "affiliated": {
            "type": "boolean",
            "description": "1 - дочерняя организация"
        },
        "international": {
            "type": "boolean",
            "description": "1 - международная организация"
        },
        "foreignInvest": {
            "type": "boolean",
            "description": "1 - с участием иностранных инвесторов"
        },
        "oneCitizenShip": {
            "type": "boolean",
            "description": "1 - Участие лиц без гражданства"
        },
        "branchesExistence": {
            "type": "boolean",
            "description": "1 - наличие филиалов и представительств"
        }
    }
}

LiquidationTypeDto

{
    "type": "object",
    "properties": {
        "liqBase": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "liqType": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "liqDecisionDate": {
            "type": "string",
            "format": "date-time",
            "description": "Дата решения о ликвидации"
        },
        "reorgType": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "binReceiver": {
            "type": "string",
            "description": "БИН правоприемника"
        }
    }
}

LeaderTypeDto

{
    "type": "object",
    "properties": {
        "position": {
            "$ref": "#\/definitions\/LeaderPositionTypeDto"
        },
        "country": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "citizenCountry": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "nationalityRelation": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "iin": {
            "type": "string",
            "description": "ИИН"
        },
        "surName": {
            "type": "string",
            "description": "Фамилия"
        },
        "name": {
            "type": "string",
            "description": "Имя"
        },
        "middleName": {
            "type": "string",
            "description": "Отчество"
        }
    }
}

ActivityTypeDto

{
    "type": "object",
    "required": [
        "activityNameKz",
        "activityNameRu"
    ],
    "properties": {
        "main": {
            "type": "boolean",
            "description": "Основной вид дейятельности?"
        },
        "oked": {
            "type": "string",
            "description": "код ОКЭД",
            "example": "64999"
        },
        "activityNameKz": {
            "type": "string",
            "description": "Название вида деятельности на государственном",
            "example": "Басқа топтамаларға енгізілмеген сақтандыру және зейнетақымен қамсыздандырудан басқа, қаржылық көрсетілетін қызметтердің басқа да түрлері"
        },
        "activityNameRu": {
            "type": "string",
            "description": "Название вида деятельности на русском языке",
            "example": "Другие виды финансовых услуг, кроме страхования и пенсионного обеспечения, не включенные в другие группировки"
        }
    }
}

AddressTypeDto

{
    "type": "object",
    "required": [
        "cityKz",
        "cityRu"
    ],
    "properties": {
        "rka": {
            "type": "string",
            "description": "Регистрационный код адреса",
            "example": "0201300080497704"
        },
        "zipCode": {
            "type": "string",
            "description": "Почтовый индекс",
            "example": "010000"
        },
        "kato": {
            "type": "string",
            "description": "Код КАТО",
            "example": "711310000"
        },
        "ate": {
            "type": "string",
            "description": "Идентификатор АТЕ с ИС АР",
            "example": "107989"
        },
        "geonimCode": {
            "type": "string",
            "description": "код геонима по ИС АР",
            "example": "108104"
        },
        "districtRu": {
            "type": "string",
            "description": "Область на русском языке",
            "example": "город Нур-Султан"
        },
        "districtKz": {
            "type": "string",
            "description": "Область на государственном языке",
            "example": "Нұр-Сұлтан қаласы"
        },
        "regionRu": {
            "type": "string",
            "description": "Район на русском языке",
            "example": "район Сарыарка"
        },
        "regionKz": {
            "type": "string",
            "description": "Район на государственном языке",
            "example": "Сарыарқа ауданы"
        },
        "ruralRu": {
            "type": "string",
            "description": "Сельский округ на русском языке"
        },
        "ruralKz": {
            "type": "string",
            "description": "Сельский округ на государственном языке"
        },
        "cityRu": {
            "type": "string",
            "description": "Населенный пункт на русском языке",
            "example": "-"
        },
        "cityKz": {
            "type": "string",
            "description": "Населенный пункт на государственном языке",
            "example": "-"
        },
        "streetRu": {
            "type": "string",
            "description": "Название улицы на русском языке",
            "example": "Проспект Республика"
        },
        "streetKz": {
            "type": "string",
            "description": "Название улицы на государственном языке",
            "example": "Республика Даңғылы"
        },
        "buildingType": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "buildingNumber": {
            "type": "string",
            "description": "Номер строения",
            "example": "29"
        },
        "block": {
            "type": "string",
            "description": "Номер блока"
        },
        "corpus": {
            "type": "string",
            "description": "Номер корпуса"
        },
        "roomType": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "appartmentNumber": {
            "type": "string",
            "description": "Номер помещения"
        },
        "officeNumber": {
            "type": "string",
            "description": "Номер офиса Не входящий в РКА"
        }
    }
}

AuthCapitalTypeDto

{
    "type": "object",
    "properties": {
        "valueAll": {
            "type": "number",
            "format": "double",
            "description": "Уставной капитал всего в тенге"
        },
        "valueGov": {
            "type": "number",
            "format": "double",
            "description": "Доля государственного в тенге"
        },
        "percentGov": {
            "type": "number",
            "format": "double",
            "description": "Доля государственного в %"
        },
        "valuePrivate": {
            "type": "number",
            "format": "double",
            "description": "Доля частного в тенге"
        },
        "percentPrivate": {
            "type": "number",
            "format": "double",
            "description": "Доля частного в %"
        }
    }
}

OrganizationShortTypeDto

{
    "type": "object",
    "required": [
        "organizationNameKz",
        "organizationNameRu",
        "registrationLastDate"
    ],
    "properties": {
        "bin": {
            "type": "string",
            "description": "БИН",
            "example": "010140017782"
        },
        "country": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "registrationNumber": {
            "type": "string",
            "description": "Регистрационный номер в стране инкорпорации для нерезидента РК"
        },
        "registrationLastDate": {
            "type": "string",
            "format": "date-time",
            "description": "Дата последней перерегистрации",
            "example": "1999-08-25T00:00:00+06:00"
        },
        "organizationNameRu": {
            "type": "string",
            "description": "Наименование организации на русском языке",
            "example": "Государственное учреждение \"Комитет государственного имущества и приватизации Министерства финансов Республики Казахстан\""
        },
        "organizationNameKz": {
            "type": "string",
            "description": "Наименование организации на государственном языке",
            "example": "\"Қазақстан Республикасы Қаржы министрлігінің Мемлекеттік мүлік және жекешелендіру комитеті\" мемлекеттік мекемесі"
        },
        "activity": {
            "type": "string",
            "description": "Вид деятельности для иностранных лиц"
        },
        "value": {
            "type": "number",
            "format": "double",
            "description": "Сумма вклада в тенге"
        },
        "percent": {
            "type": "number",
            "format": "double",
            "description": "Доля в %"
        }
    }
}

PersonTypeDto

{
    "type": "object",
    "properties": {
        "country": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "nationalityRelation": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "citizenCountry": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "iin": {
            "type": "string",
            "description": "ИИН",
            "example": "123456789012"
        },
        "taxNumber": {
            "type": "string",
            "description": "Налоговый номер в стране инкорпорации для иностранных лиц"
        },
        "surName": {
            "type": "string",
            "description": "Фамилия"
        },
        "name": {
            "type": "string",
            "description": "Имя"
        },
        "middleName": {
            "type": "string",
            "description": "Отчество"
        },
        "value": {
            "type": "number",
            "format": "double",
            "description": "Сумма вклада в тенге"
        },
        "percent": {
            "type": "number",
            "format": "double",
            "description": "Доля в %"
        }
    }
}

HeadTypeDto

{
    "type": "object",
    "required": [
        "organizationNameKz",
        "organizationNameRu",
        "registrationLastDate"
    ],
    "properties": {
        "bin": {
            "type": "string",
            "description": "БИН"
        },
        "country": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "registrationNumber": {
            "type": "string",
            "description": "Регистрационный номер в стране инкорпорации для нерезидента РК"
        },
        "registrationLastDate": {
            "type": "string",
            "format": "date-time",
            "description": "Дата последней перерегистрации"
        },
        "organizationNameRu": {
            "type": "string",
            "description": "Наименование организации на русском языке"
        },
        "organizationNameKz": {
            "type": "string",
            "description": "Наименование организации на государственном языке"
        },
        "activity": {
            "type": "string",
            "description": "Вид деятельности для иностранных лиц"
        }
    }
}

StatCommInfoTypeDto

{
    "type": "object",
    "properties": {
        "orgSize": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "activityAttr": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "addressFact": {
            "$ref": "#\/definitions\/AddressStatTypeDto"
        },
        "activity": {
            "type": "array",
            "items": {
                "$ref": "#\/definitions\/ActivityTypeDto"
            },
            "description": "Вид деятельности"
        },
        "actualDate": {
            "type": "string",
            "format": "date-time",
            "description": "Дата получения актуализации",
            "example": "2021-10-26T00:00:00+06:00"
        }
    }
}

ReorganizationTypeDto

{
    "type": "object",
    "required": [
        "binReorganizationUl"
    ],
    "properties": {
        "binReorganizationUl": {
            "type": "array",
            "items": {
                "type": "string",
                "description": "БИН реорганизованного юрлица"
            },
            "description": "Список БИН реорганизованных юрлиц"
        }
    }
}

BenefiziarsTypeDto

{
    "type": "object",
    "required": [
        "benefiziar"
    ],
    "properties": {
        "benefiziar": {
            "type": "array",
            "items": {
                "$ref": "#\/definitions\/BenefiziarPersonTypeDto"
            },
            "description": "Бенефициар юридического лица"
        }
    }
}

LeaderIpsNerezTypeDto

{
    "type": "object",
    "properties": {
        "iin": {
            "type": "string",
            "description": "ИИН"
        },
        "surName": {
            "type": "string",
            "description": "Фамилия"
        },
        "name": {
            "type": "string",
            "description": "Имя"
        },
        "middleName": {
            "type": "string",
            "description": "Отчество"
        }
    }
}

AddressIpsNerezTypeDto

{
    "type": "object",
    "properties": {
        "kato": {
            "type": "string",
            "description": "Код КАТО"
        },
        "districtRu": {
            "type": "string",
            "description": "Область на русском языке"
        },
        "districtKz": {
            "type": "string",
            "description": "Область на государственном языке"
        },
        "regionRu": {
            "type": "string",
            "description": "Район на русском языке"
        },
        "regionKz": {
            "type": "string",
            "description": "Район на государственном языке"
        },
        "cityRu": {
            "type": "string",
            "description": "Населенный пункт на русском языке"
        },
        "cityKz": {
            "type": "string",
            "description": "Населенный пункт на государственном языке"
        },
        "streetRu": {
            "type": "string",
            "description": "Название улицы на русском языке"
        },
        "streetKz": {
            "type": "string",
            "description": "Название улицы на государственном языке"
        },
        "buildingNumber": {
            "type": "string",
            "description": "Номер строения"
        },
        "appartmentNumber": {
            "type": "string",
            "description": "Номер квартиры, офиса"
        }
    }
}

LeaderPositionTypeDto

{
    "type": "object",
    "required": [
        "positionType"
    ],
    "properties": {
        "positionType": {
            "$ref": "#\/definitions\/DictionaryTypeDto"
        },
        "issueDate": {
            "type": "string",
            "format": "date-time",
            "description": "Дата назначения"
        },
        "lossDate": {
            "type": "string",
            "format": "date-time",
            "description": "Дата отстранения от должности или Дата утраты силы должности управляющего"
        }
    }
}

AddressStatTypeDto

{
    "type": "object",
    "required": [
        "nameKz",
        "nameRu"
    ],
    "properties": {
        "rka": {
            "type": "string",
            "description": "Регистрационный код адреса",
            "example": "0201300080497704"
        },
        "kato": {
            "type": "string",
            "description": "Код КАТО",
            "example": "711310000"
        },
        "nameRu": {
            "type": "string",
            "description": "адрес на русском языке",
            "example": "Г.НУР-СУЛТАН РАЙОН САРЫАРКА Проспект РЕСПУБЛИКИ, дом 29"
        },
        "nameKz": {
            "type": "string",
            "description": "адрес на государственном языке",
            "example": "НҰР-СҰЛТАН Қ. САРЫАРҚА АУДАНЫ РЕСПУБЛИКИ Даңғылы, дом 29"
        }
    }
}

BenefiziarPersonTypeDto

{
    "type": "object",
    "required": [
        "citizenshipRelationCode",
        "countryOfResidence"
    ],
    "properties": {
        "countryOfResidence": {
            "type": "string",
            "description": "Страна местожительства"
        },
        "countryOfCitizenship": {
            "type": "string",
            "description": "Страна гражданства"
        },
        "citizenshipRelationCode": {
            "type": "string",
            "description": "Код отношения к гражданству"
        },
        "iin": {
            "type": "string",
            "description": "ИИН"
        },
        "taxNumberIncCountry": {
            "type": "string",
            "description": "Налоговый номер в стране инкорпарации"
        },
        "personStatusInGBDFL": {
            "type": "string",
            "description": "Статус лица в ГБДФЛ"
        },
        "surname": {
            "type": "string",
            "description": "Фамилия"
        },
        "name": {
            "type": "string",
            "description": "Имя"
        },
        "middlename": {
            "type": "string",
            "description": "Отчество"
        },
        "birthday": {
            "type": "string",
            "format": "date-time",
            "description": "Дата рождения"
        },
        "identityDocument": {
            "$ref": "#\/definitions\/DocumentTypeDto"
        }
    }
}

DocumentTypeDto

{
    "type": "object",
    "required": [
        "documentNumber",
        "documentType",
        "issueDate",
        "issuerId"
    ],
    "properties": {
        "documentType": {
            "type": "string",
            "description": "код документа из ГБД ФЛ"
        },
        "documentNumber": {
            "type": "string",
            "description": "номер документа"
        },
        "issueDate": {
            "type": "string",
            "format": "date-time",
            "description": "дата выдачи"
        },
        "issuerId": {
            "type": "string",
            "description": "код органа выдачи из ГБД ФЛ"
        }
    }
}

Developer portal

Languages

Menu

GbdulInfoByBinV2 API

GbdulInfoByBinV2 API 1.0.0

Paths

/{bin}

Definitions

GbdulInfoByBinV2 API 1.0.0

Paths

/{bin}

Definitions

User login