--- updatedAt: 2025-11-10T23:57:49.000Z agentTools: projectIndex: https://docs.interswitchgroup.com/llms.txt --- # Get Dispute Use this endpoint to retrieve a dispute by the log code **REQUEST** | Field Name | Description | Type | Required | Constraints | | :--------- | :-------------------------- | :----- | :------- | :---------- | | logCode | The log code of the dispute | String | Optional | | **Sample Request** \{\{base\_url}}/api/v1/disputes/IBTC0II62943 **RESPONSE** | Field Name | Description | Type | Constraint | | :---------------------- | :----------------------------------------------------------------------- | :---------- | :-------------------------------------------------------- | | logCode | The log code of the dispute | String | | | issuerCode | The domain code of the issuer | String | | | issuer | The domain name of the issuer | String | | | acquirerCode | The domain code of the acquirer | String | | | acquirer | The domain name of the acquirer | String | | | merchantCode | The domain code of the merchant, if applicable | String | | | merchant | The domain name of the merchant, if applicable | String | | | customerReference | The reference of the customer | String | | | transactionStore | The store of the transaction | String | | | transactionReference | The unique reference of the transaction in the store | String | | | transactionDate | The UTC date and time of the transaction | String | | | transactionType | The type of the transaction | String | [refer to Get Transaction Types](get-transaction-types-1) | | transactionAmount | The amount of the transaction | String | | | surchargeAmount | The surcharge (or fee) of the transaction, if applicable | String | | | transactionCurrencyCode | The currency of the transaction. Format: ISO 4217 numeric | String | | | settlementAmount | The settlement amount of the transaction | String | | | settlementCurrencyCode | The currency of the transaction settlement. Format: ISO 4217 numeric | String | | | terminalType | The type of the terminal | String | | | disputeAmountType | The type of the dispute amount | Enum | FULL or PARTIAL | | disputeAmount | The amount of the dispute | String | | | additionalInfo | Any additional data from the transaction | JSON String | | | reasonCode | The code of reason of the dispute | String | [refer to Get Dispute Reasons](get-dispute-reasons) | | reason | The reason for the dispute | String | [refer to Get Dispute Reasons](get-dispute-reasons) | | category | The category of the dispute | String | [refer to Get Dispute Categories](get-dispute-categories) | | region | The region of the dispute | String | | | merchantDisputant | Indicates whether the dispute is managed by the merchant or the acquirer | Boolean | | | domainCode | The domain code of the issuer of the dispute | String | | | status | The current status of the dispute | String | | | previousStatus | The previous status of the dispute | String | | | statusStartDate | The UTC date and time the current status began | DateTime | | | createdBy | The user that logged the dispute | String | | | createdOn | The UTC date and time the dispute was logged | DateTime | | | accountNumber | The transaction account number | String | | | merchantEmail | The email address of the merchant if applicable | String | | | pan | The masked PAN of the card used in the transaction | String | | | evidence | A list of all the evidence attached to the dispute | JSON Arrays | | | journal | An array of all attached journals | JSON Array | | **Sample Response** ```json { "logCode": "IBTC0II62943", "issuerCode": "IBTC", "issuer": "Stanbic IBTC Bank", "acquirerCode": "FBN", "acquirer": "FIRST BANK OF NIGERIA", "merchantCode": "", "merchant": "", "customerReference": "506120*********8033", "transactionStore": "RJService", "transactionReference": "136919902261_902261_20086919_-10000.00_0200", "transactionDate": "2023-04-11T11:00:00Z", "transactionType": "AGENCY_BANKING_TRANSFER", "transactionAmount": "NGN 100.00", "surchargeAmount": "NGN 0.00", "transactionCurrencyCode": "566", "settlementAmount": "NGN 0.00", "settlementCurrencyCode": "566", "terminalType": "2", "disputeAmountType": "Full", "disputeAmount": "NGN 100.00", "additionalInfo": { "Card Acceptor Code": "200001119220077", "Card Acceptor Location": "WT|ABUBAKAR MUHAMMAD MUST ZARIA NG", "Card Scheme": "Verve", "Has Merchant": true, "Merchant Type": "REGULAR", "Response Code": "00", "Retrieval Reference Number": "136919902261", "Settled": true, "Stan": "902261", "Terminal Id": "20086919" }, "reasonCode": "RG", "reason": "Non-Receipt of Goods and Services", "category": "Chargeback", "region": "DOMESTIC_AGENCY_TRANSFERS", "merchantDisputant": false, "domainCode": "IBTC", "status": "Accepted", "previousStatus": "Chargeback", "statusStartDate": "2023-09-23T22:46:58.637Z", "evidence": [], "journal": [ { "detail": "Dispute status updated: Chargeback to Accepted", "addedBy": "Emmanuel.Kpoudosu@FBN", "addedOn": "2023-09-23T22:46:58.653Z" }, { "detail": "Dispute comment added: Accept with comment", "addedBy": "Emmanuel.Kpoudosu@FBN", "addedOn": "2023-09-23T22:46:58.653Z" } ], "createdBy": "Emmanuel.Kpoudosu@ISW", "createdOn": "2023-09-23T22:30:07.087Z", "lastUpdatedBy": "Emmanuel.Kpoudosu@FBN", "lastUpdatedOn": "2023-09-23T22:46:58.653Z", "pan": "506120*********8033", "statusActions": [] } ``` # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "ipg", "version": "1.0" }, "servers": [ { "url": "https://sandbox.interswitchng.com" } ], "components": { "securitySchemes": { "sec0": { "type": "oauth2", "flows": {} } } }, "security": [ { "sec0": [] } ], "paths": { "/arbiter/api/v1/disputes/{logCode}": { "get": { "summary": "Get Dispute", "description": "Use this endpoint to retrieve a dispute by the log code", "operationId": "get-dispute", "parameters": [ { "name": "logCode", "in": "path", "description": "the log code of the dispute", "schema": { "type": "string" }, "required": true }, { "name": "Authorization", "in": "header", "description": "The token used to identify the user", "schema": { "type": "string" } }, { "name": "X-Interswitch-Authorization-Domain", "in": "header", "description": "The domain the user belongs to", "schema": { "type": "string" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{}" } }, "schema": { "type": "object", "properties": {} } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Result": { "value": "{}" } }, "schema": { "type": "object", "properties": {} } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```