Fetch milestones

Milestone transactions are necessary for buying and selling of services as it ensures sellers get paid only after achieving specific goals. All transactions inherently involve milestone stages. Parties can create as many milestones as needed within each transaction.

Fetch all milestones by transaction

GET {{api_url}}/v1/transactions/{transaction_id}/milestones

Query Parameters

Name
Type
Description

transaction_id*

string

specify the transaction id

Headers

Name
Type
Description

Authorization

string

your Trustcrow API keys to authorize customers

{
    "status": true,
    "message": "Transaction info returned successfully",
    "data": {
        "id": "2a3799a7-4dc2-4081-94eb-770bc6048a48",
        "title": "Bag of cement",
        "description": "Purchase of 3 bags of cements",
        "category": "GOODS",
        "sub_category": "Food/beverage/agriculture",
        "transaction_contract_url": "https://trustcrow-dev-docs.s3.amazonaws.com/",
        "status": "RECIPIENT_APPROVED_AWAITING_FUNDING",
        "transaction_originator": "BUYER",
        "buyer_id": "524c35c9-ef73-4a4d-a4ab-97146f3cff95",
        "seller_id": "eeae27bc-3e12-47f4-a6cb-fceaa3013629",
        "source": "api",
        "clientId": "dd2f3541-9047-46e1-b117-6ca8584ea0bd",
        "transaction_amount": 500000,
        "total_amount_funded": 0,
        "total_amount_refunded": 0,
        "total_amount_disbursed": 0,
        "current_milestone_id": null,
        "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": "369ea20c-212b-4b2a-9f87-31c7b11dec58",
        "updated_by": null,
        "date_canceled": null,
        "created_at": "2023-12-26T10:02:35.691Z",
        "updated_at": "2023-12-26T10:02:35.691Z",
        "milestones": [
            {
                "id": "4cc0a406-ad97-4aa6-9f71-bfca4404f1a5",
                "title": "Purchase of 3 bags of cements",
                "description": "Purchase of 3 bags of cements",
                "amount": 500000,
                "is_milestone_funded": false,
                "position_in_transaction": 1,
                "is_delivered": false,
                "is_completed": false,
                "delivery_rejection_reason": null,
                "is_delivery_rejected": false,
                "is_return_proof_sent": false,
                "is_return_approved": false,
                "is_return_rejected": false,
                "due_date_type": "DEADLINE_DATE",
                "due_date": "2023-12-30T00:00:00.000Z",
                "execution_timeline": null,
                "status": "PENDING",
                "commission_payer": "SELLER_100",
                "discount_code": null,
                "milestone_fee": 16250,
                "transaction_id": "2a3799a7-4dc2-4081-94eb-770bc6048a48",
                "inspection_duration": 2,
                "inspection_end_date": null,
                "return_deadline_date": null,
                "current_extension_index": null,
                "milestone_escrow_id": "8991b718-bade-4119-a4b1-e6bec59cd3b2",
                "rate_used": 1,
                "created_at": "2023-12-26T10:02:35.691Z",
                "updated_at": "2023-12-26T10:02:35.691Z"
            }
        ]
    }
}

Fetch milestone by ID

GET {{api_url}}/v1/milestones/{milestone_id}

Query Parameters

Name
Type
Description

milestone_id*

string

specify the customer id

Headers

Name
Type
Description

Authorization

string

your Trustcrow API keys to authorize customers

PreviousFetch transactionsNextFund milestone

Last updated

Was this helpful?