View Card API V2

Table of Contents

View Card API V2 Introduction
Request Format
Success Response
Failure Response

View Card API V2 Introduction

This API is used to retrieve detailed card information that already exists in the institution’s account. If you do not pass the correct ‘card-id’ or ‘card-template-id’ for the card that you are trying to retrieve, you will receive an error. All request parameters are mandatory to get the right card. A “list-cards” API returns limited information about cards and users must use the “view-card” API to get detailed information.

Request Format

Copy to Clipboard

Success Response

Copy to Clipboard

{
    "action": "view-card",
    "status": "success",
    "status-code": "SUCCESS CODE",
    "message": "SUCCESS MESSAGE",
    "data": {
        "card-template-id": "CARD_TEMPLATE_ID",
        "card-id": "CARD_ID",
        "card-status": "CARD STATUS",
        "card-sub-status": "CARD SUB STATUS",
        "institution": "INSTITUTION NAME",
        "issuance-type": "INSTITUTION ISSUED",
        "card-title": "CARD TITLE",
        "created-at": "yyyy-mm-ddThh:mm:ss+00:00", //UTC, 
        "last-updated": "UPDATED AT TIME",
        "card-expiration": "yyyy-mm-ddThh:mm:ss+00:00", UTC
        "access-control":{ 
           "acs-identifier":"ACCESS_CONTROL_SYSTEM_USER_IDENTIFIER", // Unique Identifier under ACS
           "acs-groups":"ACCESS_CONTROL_SYSTEM_PERMISSION_GROUPS" // comma-separated list of access groups
        },
        "card-data": {
            "barcode": [
                {
                    "key": "barcode",
                    "value": "",
                    "label": "barcode"
                }
            ],
            "image": [
                {
                    "key": "id-photo",
                    "value": "PHOTO URL",
                    "label": "ID PHOTO"
                }
            ],
            "name-fields": [
                {
                    "key": "name",
                    "value": "VALUE",
                    "label": "Name"
                }
            ],
            "front-fields": [
                {
                    "key": "front-1",
                    "label": "FIELD LABEL",
                    "type": "FIELD TYPE",
                    "value": "FIELD VALUE"
                }
            ],
            "secondary-fields": [
                {
                    "key": "secondary-1",
                    "label": "FIELD LABEL",
                    "type": "FIELD TYPE",
                    "value": "FIELD VALUE"
                }
            ],
            "back-fields": [
                {
                    "key": "back-1",
                    "label": "FIELD LABEL",
                    "type": "FIELD TYPE",
                    "value": "FIELD VALUE"
                },
                {
                    "key": "back-2",
                    "label": "FIELD LABEL",
                    "type": "FIELD TYPE",
                    "value": "FIELD VALUE"
                },
                {
                    "key": "back-3",
                    "label": "FIELD LABEL",
                    "type": "FIELD TYPE",
                    "value": "FIELD VALUE"
                },
                {
                    "key": "back-4",
                    "label": "FIELD LABEL",
                    "type": "FIELD TYPE",
                    "value": "FIELD VALUE"
                }
            ]
        }
    }
}

Failure Response

Copy to Clipboard

Updated on August 6, 2024

ID Card App

Digital ID Card Solution

App Security

Types of ID Cards

App Accessibility

Multi-Language Support

Identity Authentication

Types of ID Card Apps

ID Management Platform

Design Mobile ID Cards

Import Card Data

ID Photo Management

ID Card Printing Software

Issue Digital IDs via Email

Manage Issued ID Cards

Send In-App Messages

ID Barcode Scanner

Integrations

Cloud Printing

Card Data Sync

View All Integrations

Resources

Resources

Get In Touch

Support

Company

About Us

Contact Us

Partner With Us

Knowledge Base

View Card API V2 Introduction

Request Format

Success Response

Failure Response

Didn’t find what you were looking for?

ID CARD TYPES

COMPANY

RESOURCES

ACCOUNT

GET SOCIAL