Upload Certification
Upload Certification
POST https://api.iafcertsearch.org/api/client/v1/mncb/upload-cert
Fields that are marked with an asterisk (*) are mandatory.
Headers
x-http-authorization*
String
API Key received from https://iafcertsearch.org/import-management/api-integration
Example:
x-http-authorization: <<API KEY>>
Content-Type*
String
application/json
Request Body
certificate_number*
String
Certificate number shown on the certificate itself
certificate_identity_number
String
Certificate Identity Number
A unique identifier that provides a more secure form of identification.
certification_status*
String
Certification Status Include the terms that the Certification Body uses to define the status of the certification. Accepted Values: Active (valid) Inactive Withdrawn Suspended Cancelled (terminated) Hidden (where details of a certification have been uploaded but it is not yet active/live)
Expired CB Withdrawn Pending Deleted If terms vary from the above terms the IAF CertSearch will provide a mapping process
*Note: Certifications uploaded via API with the hidden certification_status displays as "Draft" when you log in to IAF CertSearch.
certificate_accreditation_status
String
Has this certificate been issued under and existing accreditation or is this an unaccredited certificate. Accepted values:
Accredited
Unaccredited
certification_type*
String
Certification Type Accepted Values: Management System If terms vary from the above terms the IAF CertSearch will provide a mapping process.
certification_scope
String
Certification Scope Example: Manufacturing, marketing and export of instruments, consumables and accessories for temperature, active oxygen, hydrogen, carbon measurements and sampling in ferrous and non-ferrous melts.
certification_original_issue_date
String
Original certification date (YYYYMMDD). Example: 20170203
certification_issue_date*
String
Most recent certification date as detailed on the certificate (YYYYMMDD). Example:
20170203
certification_expiry_date*
String
Certification expiry date as detailed on the certificate (YYYYMMDD). Example: 20170203
certified_entity_name*
String
Certified Entity Name (company name) as detailed on the certificate Example: Test Food and Logistics Inc. Reliable Logistics Services Inc.
certified_entity_trading_name
String
Certified Entity Trading Name Example: Test Food and Logistics Inc. Trading Name Reliable Logistics Services Inc. Trading Name
certified_entity_unique_id*
String
Mandatory Field provided by the Certification Body "Certified Entity Unique ID" also referred to as a client ID. The "Certified Entity Unique ID" / Client ID is a unique identification number for the organisation. The entity ID makes it possible to identify which individual certifications belong to the one organisation. The "Certified Entity Identity Number" can be any alpha numeric number. Example: UNIQUEID-COMPANY01 UNIQUEID-COMPANY02
certified_entity_street_address
String
The main entity address for the certified entity.
certified_entity_street_city
String
City of the main entity address for the certified entity.
certified_entity_state
String
State of the main entity address for the certified entity. If no state, leave blank.
certified_entity_post_code
String
Zip code or post code of the main entity address for the certified entity.
certified_entity_country*
String
Country/Economy of the main entity address for the certified entity.
certified_entity_website
String
Certified Entity Website
accreditation_body_name*
String
Accreditation Body Name
accreditation_body_acronym_name*
String
Accreditation Body Acronym Certification Bodies must apply the exact Accreditation Body acronym that IAF CertSearch uses for that Accreditation Body. This way we can map Certification Body certifications under the correct accreditation. You can view the Acronyms for all Accreditation Bodies within Data Management under "User guides". You can also use Data mapping if your system Accreditation Body acronym output is different to IAF CertSearch.
schemes*
Array
Certification Schemes Example:
{
"schemes": [
{
"scheme_name": "string",
"standard_list": [
{
"standards_name": "string"
}
]
}
]
}
sites
Array
Certification Sites Example:
{
"sites": [
{
"street": "string",
"city": "string",
"state": "string",
"country": "string",
"postcode": "string",
"scope_description": "string"
}
]
}
To delete all existing sites of a certification, set the value of the sites key to an empty array like so:
{
"sites": []
}
certified_entity_english_name
String
Certified Entity English Name Example: Test Food and Logistics Inc. English Name Reliable Logistics Services Inc. English Name
confidential_certified_entity
String
Where the confidentiality of the Certified Entity is defined. Accepted Values: Yes
No
certification_body_name*
String
Certification Body Name
certification_body_acronym_name
String
Certification Body Acronym
business_registration_number
String
Business Registration Number
Example:
1234567890A
tax_id
String
Tax Identification
Example:
000123456001
company_id_number
String
Company Identification Number
Example:
U12345ABCDE12345F123456
Upload Certification
We recommend to have an interval of 1 minute in between API requests to avoid errors during certification data publication.
To view the response data example, click the right arrow at the right side of the response description.
You can also use https://api.sandbox.iafcertsearch.org/api/client/v1/mncb/upload-cert to test it on the Sandbox server.
Take a look at how you might call this method:
Last updated