Rocket Metrics Dispute API Documentation
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"35980724","collectionId":"38eb43cd-0e71-4e54-bf83-be295a3e6541","publishedId":"2sB3B8qsVe","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-04T20:44:24.000Z"},"item":[{"name":"Auth","item":[{"name":"Get Auth Token","event":[{"listen":"test","script":{"exec":["var jsonData = pm.response.json();","pm.collectionVariables.set(\"auth_token\", jsonData.accessToken);"],"type":"text/javascript","packages":{},"id":"44c6aeef-20ed-4bee-a6e5-f17a077e216d"}}],"id":"7eb2bdfa-df20-4f40-9900-956af4487b81","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"username\": \"Submit your username and password to get a token that can be used to interact with the rest of the API.
\n","urlObject":{"path":["auth","login2"],"host":["https://mkapi.rocketmetrics.com"],"query":[],"variable":[]}},"response":[{"id":"d4fb0f37-3785-438d-ab23-0666f5f7bfa3","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"username\": \"Submit your account username or password, then get an email used to reset your password.
\n","urlObject":{"path":["forgot-password","request-reset"],"host":["https://mkapi.rocketmetrics.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"414050a1-8490-4038-9951-c9e0341532a6"}],"id":"11eed5c1-5f2c-4600-aecf-63d314b9f17f","_postman_id":"11eed5c1-5f2c-4600-aecf-63d314b9f17f","description":""},{"name":"Alerts","item":[{"name":"Search Alerts","id":"f7e280fa-b123-4220-ae99-9bee6a11386b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Search for alerts within a date range.
\nRequired query params:
\npage
startDate
endDate
Dates must be in the format \"YYYY-MM-DDThh:mm:ss\".
\nYou may also filter by the \"isResolved\" boolean.
\n","urlObject":{"path":["api","v1","alerts"],"host":["https://mkapi.rocketmetrics.com"],"query":[{"key":"page","value":"1"},{"key":"startDate","value":"2025-07-29T00:00:00"},{"key":"endDate","value":"2025-07-29T02:00:00"},{"disabled":true,"key":"isResolved","value":"true"}],"variable":[]}},"response":[{"id":"3c37fc5f-a0b1-4c9e-a077-b6161c109f89","name":"Date Range Search","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mkapi.rocketmetrics.com/api/v1/alerts?page=1&startDate=2025-07-29T00:00:00&endDate=2025-07-29T02:00:00","host":["https://mkapi.rocketmetrics.com"],"path":["api","v1","alerts"],"query":[{"key":"page","value":"1"},{"key":"startDate","value":"2025-07-29T00:00:00"},{"key":"endDate","value":"2025-07-29T02:00:00"},{"key":"isResolved","value":"true","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1462"},{"key":"ETag","value":"W/\"5b6-PIvHaAgZxPA5bzOqgaf0qgYEWxU\""},{"key":"Date","value":"Tue, 29 Jul 2025 23:08:11 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=300"}],"cookie":[],"responseTime":null,"body":"{\n \"page\": 1,\n \"totalPages\": 1,\n \"totalAlertsCount\": 5,\n \"alerts\": [\n {\n \"id\": \"OEHJ8RWIVTG5QDUXX9QUGA51H\",\n \"provider\": \"Ethoca\",\n \"alertTimestamp\": \"2025-07-29T01:58:42\",\n \"amount\": 57.13,\n \"cardBin\": \"675931\",\n \"cardLastFour\": \"4451\",\n \"currency\": \"US\",\n \"descriptor\": \"DAPPER SWEATSHIRT\",\n \"transactionTimeStamp\": \"2025-07-26T23:50:13\",\n \"isResolved\": false,\n \"cardBrand\": \"mastercard\"\n },\n {\n \"id\": \"RP5P4BZA89T6RKPKC1YOWNTB7\",\n \"provider\": \"Verifi\",\n \"alertTimestamp\": \"2025-07-29T01:27:46\",\n \"amount\": 35.34,\n \"cardBin\": \"439602\",\n \"cardLastFour\": \"9246\",\n \"currency\": \"US\",\n \"descriptor\": \"KNOTTY YARD\",\n \"transactionTimeStamp\": \"2025-07-28T23:36:52\",\n \"isResolved\": false,\n \"cardBrand\": \"amex\"\n },\n {\n \"id\": \"Q8VCYE5TSE8MFH44VGOSNHON7\",\n \"provider\": \"Verifi\",\n \"alertTimestamp\": \"2025-07-29T00:59:38\",\n \"amount\": 55.24,\n \"cardBin\": \"676722\",\n \"cardLastFour\": \"6372\",\n \"currency\": \"US\",\n \"descriptor\": \"UNLINED PRESSURISATION\",\n \"transactionTimeStamp\": \"2025-07-28T04:25:28\",\n \"isResolved\": true,\n \"cardBrand\": \"visa\"\n },\n {\n \"id\": \"S9SJ2SQYEEKWRYXCGORXYPMFZ\",\n \"provider\": \"Ethoca\",\n \"alertTimestamp\": \"2025-07-29T00:20:03\",\n \"amount\": 55.16,\n \"cardBin\": \"601162\",\n \"cardLastFour\": \"0504\",\n \"currency\": \"US\",\n \"descriptor\": \"TALL PLASTIC\",\n \"transactionTimeStamp\": \"2025-07-27T13:37:26\",\n \"isResolved\": false,\n \"cardBrand\": \"amex\"\n },\n {\n \"id\": \"QW5XOSL3WPQK4MH1WYELR3ZSM\",\n \"provider\": \"Verifi\",\n \"alertTimestamp\": \"2025-07-29T00:05:42\",\n \"amount\": 11.17,\n \"cardBin\": \"670930\",\n \"cardLastFour\": \"0297\",\n \"currency\": \"US\",\n \"descriptor\": \"ORDERLY CRAZY\",\n \"transactionTimeStamp\": \"2025-07-28T01:43:46\",\n \"isResolved\": false,\n \"cardBrand\": \"visa\"\n }\n ]\n}"},{"id":"b8831ab5-3a77-41b0-a949-cba13f7335da","name":"isResolved Search","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://mkapi.rocketmetrics.com/api/v1/alerts?page=1&endDate=2025-07-30T00:00:00&startDate=2025-07-15T00:00:00&isResolved=true","host":["https://mkapi.rocketmetrics.com"],"path":["api","v1","alerts"],"query":[{"key":"page","value":"1"},{"key":"endDate","value":"2025-07-30T00:00:00"},{"key":"startDate","value":"2025-07-15T00:00:00"},{"key":"isResolved","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"619"},{"key":"ETag","value":"W/\"26b-bFXxRQcli1C/ovrd1sPhRdnYReI\""},{"key":"Date","value":"Tue, 29 Jul 2025 23:07:03 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=300"}],"cookie":[],"responseTime":null,"body":"{\n \"page\": 1,\n \"totalPages\": 1,\n \"totalAlertsCount\": 2,\n \"alerts\": [\n {\n \"id\": \"Q8VCYE5TSE8MFH44VGOSNHON7\",\n \"provider\": \"Verifi\",\n \"alertTimestamp\": \"2025-07-29T00:59:38\",\n \"amount\": 55.24,\n \"cardBin\": \"676722\",\n \"cardLastFour\": \"6372\",\n \"currency\": \"US\",\n \"descriptor\": \"UNLINED PRESSURISATION\",\n \"transactionTimeStamp\": \"2025-07-28T04:25:28\",\n \"isResolved\": true,\n \"cardBrand\": \"visa\"\n },\n {\n \"id\": \"CLX8EFGAXC3FGWIFF7NMKNCRT\",\n \"provider\": \"Verifi\",\n \"alertTimestamp\": \"2025-07-28T20:28:52\",\n \"amount\": 30.54,\n \"cardBin\": \"677167\",\n \"cardLastFour\": \"2225\",\n \"currency\": \"US\",\n \"descriptor\": \"IDLE TSUNAMI\",\n \"transactionTimeStamp\": \"2025-07-27T16:19:03\",\n \"isResolved\": true,\n \"cardBrand\": \"amex\"\n }\n ]\n}"}],"_postman_id":"f7e280fa-b123-4220-ae99-9bee6a11386b"},{"name":"View Alert By ID","id":"c347b9a4-b3f7-4846-85cd-c208822ac7dd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Find an alert by it's provider ID.
\n","urlObject":{"path":["api","v1","alerts","Resolve an alert to one of several resolution results.
\nOnly unresolved alerts can be resolved.
\nAvailable resolution options are:
resolvedRefunded
resolvedPreviouslyRefunded
\nUse this response when the txn was refunded prior to the reception of the alert.
\nREQUIRED COMMENT CONTENTS:
Date Refunded - Amount Refunded
declinedNotFound
\nUse this response when a matching transaction for the alert cannot be found.
\nCOMMENT OPTIONAL
\ndeclinedDuplicateRequest
\nUse this response when the alert is a duplicate alert that matches the same txn as a previous alert.
\nREQUIRED COMMENT CONTENTS:
Duplicate Ethoca ID #
declinedDeclinedSale
\nUse this response if the txn was not authorized.
\nCOMMENT OPTIONAL
\nresolvedVoidSale
\nUse this response if the sale was voided before it was settled.
\nCOMMENT OPTIONAL
\nresolvedRefundFailed
\nUse this response if a refund was attempted but is not possible.
\nCOMMENT OPTIONAL
\nSANDBOX ONLY
Use this endpoint to reset your sandbox environment for testing purposes. All existing sandbox alerts will be deleted, and replaced with mock data. You may request up to 1000 alerts for testing purposes. Alerts will have randomly assigned timestamps between when the api call is executed and 3 days backwards.