{
    "openapi": "3.0.3",
    "info": {
        "title": "VictorHub API",
        "version": "4.0.0"
    },
    "servers": [
        {
            "url": "https://victorhub.in"
        }
    ],
    "paths": {
        "/api/v1/pan/details": {
            "post": {
                "summary": "PAN Details",
                "description": "PAN details lookup. Disabled until the administrator reviews the provider contract and approves access.",
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Completed outcome; inspect status"
                    },
                    "202": {
                        "description": "Unknown/pending outcome; reservation retained"
                    },
                    "503": {
                        "description": "Service unavailable"
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "panNumber",
                                    "consent",
                                    "consent_reference"
                                ],
                                "properties": {
                                    "panNumber": {
                                        "type": "string",
                                        "validation": "pan",
                                        "example": "ABCDE1234F"
                                    },
                                    "consent": {
                                        "type": "boolean",
                                        "enum": [
                                            true
                                        ]
                                    },
                                    "consent_reference": {
                                        "type": "string"
                                    }
                                }
                            },
                            "example": {
                                "panNumber": "ABCDE1234F",
                                "consent": true,
                                "consent_reference": "YOUR_CONSENT_RECORD"
                            }
                        }
                    }
                }
            },
            "get": {
                "summary": "PAN Details",
                "description": "PAN details lookup. Disabled until the administrator reviews the provider contract and approves access.",
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "parameters": [
                    {
                        "name": "Idempotency-Key",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "panNumber",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "boolean"
                        }
                    },
                    {
                        "name": "consent_reference",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Completed outcome; inspect status"
                    },
                    "202": {
                        "description": "Unknown/pending outcome; reservation retained"
                    },
                    "503": {
                        "description": "Service unavailable"
                    }
                }
            }
        }
    },
    "components": {
        "securitySchemes": {
            "bearerAuth": {
                "type": "http",
                "scheme": "bearer"
            }
        }
    }
}