Fetch dispute

You can fetch a dispute by its corresponding ID or the userID.

Fetch dispute by ID

GET {{api_url}}/v1/dispute/{{dispute_id}}

Headers

NameTypeDescription

Accepts

string

application/json

Authorization

string

your Trustcrow API keys with which you authorize customers.

{
    "status": true,
    "message": "Dispute retrieve successfully",
    "data": [
        {
            "id": "c476096f-ffdc-4107-af5b-2b277bd4c9eb",
            "dispute_code": "TRU_DIS_BWMQC7CJX2Z4MJAH",
            "description": "string",
            "buyer_id": "524c35c9-ef73-4a4d-a4ab-97146f3cff95",
            "seller_id": "eeae27bc-3e12-47f4-a6cb-fceaa3013629",
            "status": "INTRA_PARTY_MEDIATION",
            "dispute_amount_status": "PENDING",
            "dispute_amount": 0,
            "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
            "is_buyer_evidence_submitted": false,
            "is_seller_evidence_submitted": false,
            "intra_party_mediation_end_date": "2023-12-31T14:29:48.389Z",
            "evidence_submission_end_date": null,
            "created_by": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
            "cancellation_agreement_details": null,
            "canceled_by": null,
            "created_at": "2023-12-28T14:29:48.459Z",
            "updated_at": "2023-12-28T14:29:48.459Z",
            "buyer": {
                "id": "524c35c9-ef73-4a4d-a4ab-97146f3cff95",
                "user_id": "369ea20c-212b-4b2a-9f87-31c7b11dec58",
                "organisation_id": "7019af1c-5762-443a-880f-6d950f31ce9f",
                "role": "SUPER ADMIN",
                "created_at": "2023-12-26T09:03:18.782Z",
                "updated_at": "2023-12-26T09:03:18.782Z",
                "user": {
                    "id": "369ea20c-212b-4b2a-9f87-31c7b11dec58",
                    "first_name": "Haleemah",
                    "last_name": "Opeyemi",
                    "user_name": "haopho31079",
                    "email": "haleemahfolag@yopmail.com",
                    "default_email": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1_haleemahfolag@yopmail.com",
                    "phone": null,
                    "password": "$2b$10$H0xNaaLKERiHLvWsLQQLXegJtcBZvq64wAgfB5Yo53OzAsa8COM0C",
                    "is_account_verified": true,
                    "password_reset": false,
                    "role": "USER",
                    "referredById": null,
                    "referral_code": null,
                    "clientId": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
                    "source": "THIRD_PARTY",
                    "public_key": null,
                    "secret_key": null,
                    "api_enabled": false,
                    "password_created": false,
                    "last_logged_in_at": "2023-12-27T18:55:47.527Z",
                    "created_at": "2023-12-26T09:03:18.766Z",
                    "updated_at": "2023-12-27T18:55:47.532Z"
                }
            },
            "seller": {
                "id": "eeae27bc-3e12-47f4-a6cb-fceaa3013629",
                "user_id": "7c4e5b33-eb74-41fd-8f07-230cfaeb2439",
                "organisation_id": "9876d61f-ad34-4d5a-be9d-46bee63c8c4a",
                "role": "SUPER ADMIN",
                "created_at": "2023-12-26T09:56:54.276Z",
                "updated_at": "2023-12-26T09:56:54.276Z",
                "user": {
                    "id": "7c4e5b33-eb74-41fd-8f07-230cfaeb2439",
                    "first_name": "John",
                    "last_name": "Doe",
                    "user_name": "jodojd30278",
                    "email": "joe@yopmail.com",
                    "default_email": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1_joe@yopmail.com",
                    "phone": null,
                    "password": "$2b$10$.z0AxFZGE5rNdmxW0IJ3Zuu6TszOe.1Azqyx0RC71uQ20QvX6TTGO",
                    "is_account_verified": true,
                    "password_reset": false,
                    "role": "USER",
                    "referredById": null,
                    "referral_code": null,
                    "clientId": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
                    "source": "THIRD_PARTY",
                    "public_key": null,
                    "secret_key": null,
                    "api_enabled": false,
                    "password_created": false,
                    "last_logged_in_at": "2023-12-27T17:52:27.017Z",
                    "created_at": "2023-12-26T09:56:54.249Z",
                    "updated_at": "2023-12-27T17:52:27.030Z"
                }
            },
            "milestone": {
                "id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                "title": "testing milestone title",
                "description": "testing milestone description",
                "amount": 500,
                "is_milestone_funded": true,
                "position_in_transaction": 1,
                "is_delivered": true,
                "is_completed": false,
                "delivery_rejection_reason": "I do whatever I like",
                "is_delivery_rejected": false,
                "is_return_proof_sent": false,
                "is_return_approved": false,
                "is_return_rejected": true,
                "due_date_type": "DEADLINE_DATE",
                "due_date": "2023-12-31T00:00:00.000Z",
                "execution_timeline": null,
                "status": "IN_DISPUTE",
                "commission_payer": "SELLER_100",
                "discount_code": null,
                "milestone_fee": 16.25,
                "transaction_id": "be8232a0-af40-4dd5-9370-041153200cb9",
                "inspection_duration": 2,
                "inspection_end_date": "2023-12-30T10:07:53.465Z",
                "return_deadline_date": "2023-12-31T10:08:05.830Z",
                "current_extension_index": null,
                "milestone_escrow_id": "4017ad17-3742-4e7e-9591-9b6c64fe3d95",
                "rate_used": 1,
                "created_at": "2023-12-27T15:32:44.884Z",
                "updated_at": "2023-12-28T10:08:30.979Z",
                "transaction": {
                    "id": "be8232a0-af40-4dd5-9370-041153200cb9",
                    "title": "sales of team",
                    "description": "Sales of heavy agricultural produce",
                    "currency": "NGN",
                    "location_type": "LOCAL",
                    "category": "GOODS",
                    "sub_category": "Food/beverage/agriculture",
                    "transaction_contract_url": "https://trustcrow-dev-docs.s3.amazonaws.com/",
                    "status": "MILESTONE_IN_DISPUTE",
                    "transaction_originator": "BUYER",
                    "buyer_id": "524c35c9-ef73-4a4d-a4ab-97146f3cff95",
                    "seller_id": "eeae27bc-3e12-47f4-a6cb-fceaa3013629",
                    "source": "api",
                    "clientId": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
                    "transaction_amount": 500,
                    "total_amount_funded": 500,
                    "total_amount_refunded": 0,
                    "total_amount_disbursed": 0,
                    "current_milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                    "job_id": null,
                    "decline_reason": null,
                    "is_completed": false,
                    "has_buyer_rated": false,
                    "on_last_milestone": true,
                    "has_seller_rated": false,
                    "discount_code": null,
                    "declined_at": null,
                    "approved_at": null,
                    "created_by": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
                    "updated_by": null,
                    "date_canceled": null,
                    "created_at": "2023-12-27T15:32:44.884Z",
                    "updated_at": "2023-12-28T11:01:59.625Z"
                },
                "milestone_logs": [
                    {
                        "id": "440ad061-80c0-4a3f-bde3-5609f53bb09a",
                        "log_message": "Milestone Due Date set to 2023-12-31T00:00:00.000Z",
                        "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                        "created_at": "2023-12-28T10:07:22.570Z",
                        "updated_at": "2023-12-28T10:07:22.570Z"
                    },
                    {
                        "id": "80b958c2-d882-4d57-ba30-3bc97ecd0f01",
                        "log_message": "Milestone #1 inspection started",
                        "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                        "created_at": "2023-12-28T10:07:53.475Z",
                        "updated_at": "2023-12-28T10:07:53.475Z"
                    },
                    {
                        "id": "824d21c1-34d3-4a9e-a495-6acfc9b9dfb4",
                        "log_message": "Buyer has rejected the delivery of this milestone",
                        "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                        "created_at": "2023-12-28T10:08:05.832Z",
                        "updated_at": "2023-12-28T10:08:05.832Z"
                    },
                    {
                        "id": "d42b90bf-5754-454e-8094-b24fad683763",
                        "log_message": "Milestone 1 delivery returned by buyer,awaiting approval from seller",
                        "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                        "created_at": "2023-12-28T10:08:05.848Z",
                        "updated_at": "2023-12-28T10:08:05.848Z"
                    },
                    {
                        "id": "b6d9a8de-2349-4850-abdd-23a34816480b",
                        "log_message": "Seller has rejected the return of this milestone delivery and a dispute process has been initiated",
                        "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                        "created_at": "2023-12-28T10:08:15.053Z",
                        "updated_at": "2023-12-28T10:08:15.053Z"
                    }
                ]
            }
        }
    ]
}

Fetch dispute by userID

GET {{api_url}}/v1/dispute/user/{{user_id}}

Headers

NameTypeDescription

Accepts

string

application/json

Authorization

string

your Trustcrow API keys with which you authorize customers.

{
    "status": true,
    "message": "Dispute retrieve successfully",
    "data": [
        {
            "id": "c476096f-ffdc-4107-af5b-2b277bd4c9eb",
            "dispute_code": "TRU_DIS_BWMQC7CJX2Z4MJAH",
            "description": "string",
            "buyer_id": "524c35c9-ef73-4a4d-a4ab-97146f3cff95",
            "seller_id": "eeae27bc-3e12-47f4-a6cb-fceaa3013629",
            "status": "INTRA_PARTY_MEDIATION",
            "dispute_amount_status": "PENDING",
            "dispute_amount": 0,
            "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
            "is_buyer_evidence_submitted": false,
            "is_seller_evidence_submitted": false,
            "intra_party_mediation_end_date": "2023-12-31T14:29:48.389Z",
            "evidence_submission_end_date": null,
            "created_by": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
            "cancellation_agreement_details": null,
            "canceled_by": null,
            "created_at": "2023-12-28T14:29:48.459Z",
            "updated_at": "2023-12-28T14:29:48.459Z",
            "buyer": {
                "id": "524c35c9-ef73-4a4d-a4ab-97146f3cff95",
                "user_id": "369ea20c-212b-4b2a-9f87-31c7b11dec58",
                "organisation_id": "7019af1c-5762-443a-880f-6d950f31ce9f",
                "role": "SUPER ADMIN",
                "created_at": "2023-12-26T09:03:18.782Z",
                "updated_at": "2023-12-26T09:03:18.782Z",
                "user": {
                    "id": "369ea20c-212b-4b2a-9f87-31c7b11dec58",
                    "first_name": "Haleemah",
                    "last_name": "Opeyemi",
                    "user_name": "haopho31079",
                    "email": "haleemahfolag@yopmail.com",
                    "default_email": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1_haleemahfolag@yopmail.com",
                    "phone": null,
                    "password": "$2b$10$H0xNaaLKERiHLvWsLQQLXegJtcBZvq64wAgfB5Yo53OzAsa8COM0C",
                    "is_account_verified": true,
                    "password_reset": false,
                    "role": "USER",
                    "referredById": null,
                    "referral_code": null,
                    "clientId": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
                    "source": "THIRD_PARTY",
                    "public_key": null,
                    "secret_key": null,
                    "api_enabled": false,
                    "password_created": false,
                    "last_logged_in_at": "2023-12-27T18:55:47.527Z",
                    "created_at": "2023-12-26T09:03:18.766Z",
                    "updated_at": "2023-12-27T18:55:47.532Z"
                }
            },
            "seller": {
                "id": "eeae27bc-3e12-47f4-a6cb-fceaa3013629",
                "user_id": "7c4e5b33-eb74-41fd-8f07-230cfaeb2439",
                "organisation_id": "9876d61f-ad34-4d5a-be9d-46bee63c8c4a",
                "role": "SUPER ADMIN",
                "created_at": "2023-12-26T09:56:54.276Z",
                "updated_at": "2023-12-26T09:56:54.276Z",
                "user": {
                    "id": "7c4e5b33-eb74-41fd-8f07-230cfaeb2439",
                    "first_name": "John",
                    "last_name": "Doe",
                    "user_name": "jodojd30278",
                    "email": "joe@yopmail.com",
                    "default_email": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1_joe@yopmail.com",
                    "phone": null,
                    "password": "$2b$10$.z0AxFZGE5rNdmxW0IJ3Zuu6TszOe.1Azqyx0RC71uQ20QvX6TTGO",
                    "is_account_verified": true,
                    "password_reset": false,
                    "role": "USER",
                    "referredById": null,
                    "referral_code": null,
                    "clientId": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
                    "source": "THIRD_PARTY",
                    "public_key": null,
                    "secret_key": null,
                    "api_enabled": false,
                    "password_created": false,
                    "last_logged_in_at": "2023-12-27T17:52:27.017Z",
                    "created_at": "2023-12-26T09:56:54.249Z",
                    "updated_at": "2023-12-27T17:52:27.030Z"
                }
            },
            "milestone": {
                "id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                "title": "testing milestone title",
                "description": "testing milestone description",
                "amount": 500,
                "is_milestone_funded": true,
                "position_in_transaction": 1,
                "is_delivered": true,
                "is_completed": false,
                "delivery_rejection_reason": "I do whatever I like",
                "is_delivery_rejected": false,
                "is_return_proof_sent": false,
                "is_return_approved": false,
                "is_return_rejected": true,
                "due_date_type": "DEADLINE_DATE",
                "due_date": "2023-12-31T00:00:00.000Z",
                "execution_timeline": null,
                "status": "IN_DISPUTE",
                "commission_payer": "SELLER_100",
                "discount_code": null,
                "milestone_fee": 16.25,
                "transaction_id": "be8232a0-af40-4dd5-9370-041153200cb9",
                "inspection_duration": 2,
                "inspection_end_date": "2023-12-30T10:07:53.465Z",
                "return_deadline_date": "2023-12-31T10:08:05.830Z",
                "current_extension_index": null,
                "milestone_escrow_id": "4017ad17-3742-4e7e-9591-9b6c64fe3d95",
                "rate_used": 1,
                "created_at": "2023-12-27T15:32:44.884Z",
                "updated_at": "2023-12-28T10:08:30.979Z",
                "transaction": {
                    "id": "be8232a0-af40-4dd5-9370-041153200cb9",
                    "title": "sales of team",
                    "description": "Sales of heavy agricultural produce",
                    "currency": "NGN",
                    "location_type": "LOCAL",
                    "category": "GOODS",
                    "sub_category": "Food/beverage/agriculture",
                    "transaction_contract_url": "https://trustcrow-dev-docs.s3.amazonaws.com/",
                    "status": "MILESTONE_IN_DISPUTE",
                    "transaction_originator": "BUYER",
                    "buyer_id": "524c35c9-ef73-4a4d-a4ab-97146f3cff95",
                    "seller_id": "eeae27bc-3e12-47f4-a6cb-fceaa3013629",
                    "source": "api",
                    "clientId": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
                    "transaction_amount": 500,
                    "total_amount_funded": 500,
                    "total_amount_refunded": 0,
                    "total_amount_disbursed": 0,
                    "current_milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                    "job_id": null,
                    "decline_reason": null,
                    "is_completed": false,
                    "has_buyer_rated": false,
                    "on_last_milestone": true,
                    "has_seller_rated": false,
                    "discount_code": null,
                    "declined_at": null,
                    "approved_at": null,
                    "created_by": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
                    "updated_by": null,
                    "date_canceled": null,
                    "created_at": "2023-12-27T15:32:44.884Z",
                    "updated_at": "2023-12-28T11:01:59.625Z"
                },
                "milestone_logs": [
                    {
                        "id": "440ad061-80c0-4a3f-bde3-5609f53bb09a",
                        "log_message": "Milestone Due Date set to 2023-12-31T00:00:00.000Z",
                        "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                        "created_at": "2023-12-28T10:07:22.570Z",
                        "updated_at": "2023-12-28T10:07:22.570Z"
                    },
                    {
                        "id": "80b958c2-d882-4d57-ba30-3bc97ecd0f01",
                        "log_message": "Milestone #1 inspection started",
                        "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                        "created_at": "2023-12-28T10:07:53.475Z",
                        "updated_at": "2023-12-28T10:07:53.475Z"
                    },
                    {
                        "id": "824d21c1-34d3-4a9e-a495-6acfc9b9dfb4",
                        "log_message": "Buyer has rejected the delivery of this milestone",
                        "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                        "created_at": "2023-12-28T10:08:05.832Z",
                        "updated_at": "2023-12-28T10:08:05.832Z"
                    },
                    {
                        "id": "d42b90bf-5754-454e-8094-b24fad683763",
                        "log_message": "Milestone 1 delivery returned by buyer,awaiting approval from seller",
                        "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                        "created_at": "2023-12-28T10:08:05.848Z",
                        "updated_at": "2023-12-28T10:08:05.848Z"
                    },
                    {
                        "id": "b6d9a8de-2349-4850-abdd-23a34816480b",
                        "log_message": "Seller has rejected the return of this milestone delivery and a dispute process has been initiated",
                        "milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
                        "created_at": "2023-12-28T10:08:15.053Z",
                        "updated_at": "2023-12-28T10:08:15.053Z"
                    }
                ]
            }
        }
    ]
}

Last updated