Professional Card

Description

A solution for the validation of professional cards (SEP), obtain the information by entering the number of the professional card or the name of the person.

HTTP method POST

Endpoint

https://api.msla-id.com/experience-idv-professionalassociations-api-v1/api/idv-govcheck/v1/mx-identity/professional-cards

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

info

Before proceeding, make sure you have your jwt token, if you don't, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

Body request (JSON)

All fields are optional, but at least one of them must be sent. An empty body (or only blank values) returns 400 IDV-2002.

NAME	REQUIRED	TYPE	DESCRIPTION	EXAMPLE
professionalId	Optional	string	Professional card number issued by the SEP	1234567
firstName	Optional	string	First name(s) of the person	JUAN CARLOS
paternalSurname	Optional	string	Paternal surname	PEREZ
maternalSurname	Optional	string	Maternal surname	LOPEZ

Search by card number

{
    "professionalId": "1234567"
}

Search by name

{
    "firstName": "JUAN CARLOS",
    "paternalSurname": "PEREZ",
    "maternalSurname": "LOPEZ"
}

Status code responses

Code	Description
200	OK. Returns data.validationCode and data.professionalCards.
400	IDV-2002 Bad request - You have to add at least one search parameter
401	Unauthorized (empty body)
404	IDV-1002 Data not found
500	IDV-1008 Internal server error
504	IDV-1100 Gateway timeout

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "123456789010101",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "data": {
        "validationCode": "bl1788324399.0171921",
        "professionalCards": [
            {
                "cardNumber": "1234567",
                "institution": "UNIVERSIDAD NACIONAL AUTONOMA DE MEXICO",
                "firstName": "JUAN CARLOS",
                "paternalSurname": "PEREZ",
                "maternalSurname": "LOPEZ",
                "sex": "M",
                "type": "C1",
                "title": "LICENCIADO EN DERECHO"
            }
        ]
    }
}

A search by a common name can return many professional cards (there is no result limit). When you know the card number, search by professionalId.

Response fields

FIELD	TYPE	DESCRIPTION
data.validationCode	string	Unique identifier of the query. Keep it for traceability.
data.professionalCards[].cardNumber	string	Professional card number.
data.professionalCards[].institution	string	Institution that issued the degree.
data.professionalCards[].firstName	string	First name(s) of the holder.
data.professionalCards[].paternalSurname	string	Paternal surname of the holder.
data.professionalCards[].maternalSurname	string	Maternal surname of the holder. Can be null.
data.professionalCards[].sex	string	Sex of the holder: M (male) or F (female).
data.professionalCards[].type	string	Type of professional card.
data.professionalCards[].title	string	Professional title.

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-2002",
    "message": "Bad request - You have to add at least one search parameter",
    "data": null
}

Response 401 status code

The response has no body (empty): the token is validated by the platform before reaching the service.

Response 404 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1002",
    "message": "Data not found.",
    "data": null
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administration.",
    "data": null
}

Response 504 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1100",
    "message": "Gateway Timeout",
    "data": null
}