Login User with Refresh Token

POST

/v1/refresh

Vendor Access: Allowed — Vendor users can access this endpoint.

Allows an active user session to remain valid without requiring the user to re-enter their username and password. When your initial accessToken expires, send the refreshToken to this endpoint to receive a new set of credentials.

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Query Params

Body Params

application/json

Examples

Responses

🟢200

application/json

Returns the token and refresh token.

Body

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.ordermesh.io/user/v1/refresh?source=' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "refreshToken": "eyJhbGciOiJSUzI1NiIsInR5cCIg..."
}'

Response Example

200 - Success

{
    "accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCIg...",
    "scope": "email profile",
    "tokenType": "Bearer",
    "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUI...",
    "expiresIn": 900,
    "identityToken": null,
    "id": "c8f51b34-3c03-417c-b3ff-1e49a159e851",
    "shortId": "U02270001",
    "username": "",
    "email": "joe.bloggs@domain.com",
    "firstName": "Joe",
    "lastName": "Bloggs",
    "status": "enabled",
    "dateCreated": "2026-07-01T14:45:31.3583692Z",
    "attributes": {
        "merchantIds": [
            "merchant-1",
            "merchant-2"
        ],
        "vendorIds": [
            "vendor-1"
        ],
        "facilityIds": [
            "facility-1"
        ]
    },
    "roles": [
        {
            "id": "03d5cd96-6d1e-46de-94c3-ceeb57feeadb",
            "name": "merchant",
            "usersCount": null,
            "ownerId": null,
            "organizationType": null,
            "permissionSet": [
                {
                    "resourceId": "33c7a0f0-0036-4461-b677-97520b874824",
                    "resourceName": "order",
                    "resourceDisplayName": "Order",
                    "availablePermissions": [
                        {
                            "name": "get",
                            "description": ""
                        },
                        {
                            "name": "create",
                            "description": ""
                        }
                    ],
                    "associatedPermissions": [
                        {
                            "name": "get",
                            "description": ""
                        }
                    ]
                }
            ]
        }
    ]
}

Modified at 2026-09-10 16:13:22

Search for order items based on various criteria and filters