Request

POST /trip/request
application/json

Body Required

  • address string
  • latitude number(double)
  • longitude number(double)
  • provider string(uuid)
  • category string

    Values are MECHANIC, PLUMBER, ELECTRICIAN, BUSINESS, PERSONAL_SHOPPER, HOUSE_KEEPING, CARPENTER, GENERATOR_REPAIR, HOME_INSTALLER, GUEST, or USER.

  • audio object

    Additional properties are allowed.

    Hide audio attributes Show audio attributes object
    • path string
    • media string
    • bytes string(byte)
  • problem string
  • car string
  • amount integer(int32)
  • place_id string
  • shopping_location object

    Additional properties are allowed.

    Hide shopping_location attributes Show shopping_location attributes object
    • address string
    • latitude number(double)
    • longitude number(double)
    • place_id string
  • shopping_items array[object]
    Hide shopping_items attributes Show shopping_items attributes object
    • item string
    • amount integer(int32)
    • quantity integer(int32)

Responses

  • 200 */*

    OK

    Hide response attributes Show response attributes object
    • status string
    • code integer(int32)
    • message string
    • data object

      Additional properties are allowed.

      Hide data attributes Show data attributes object
      • id string
      • mode string
      • snt string
      • skill string
      • car string
      • category string
      • image string
      • audio string
      • problem string
      • amount string
      • address string
      • placeId string
      • latitude number(double)
      • longitude number(double)
      • label string
      • status string

        Values are ACTIVE, CLOSED, UNFULFILLED, or WAITING.

      • type string

        Values are REQUEST, SPEAK_TO, or DRIVE_TO.

      • provider object

        Additional properties are allowed.

        Hide provider attributes Show provider attributes object
        • id string
        • name string
        • avatar string
        • role string
        • category string
        • image string
        • rating number(double)
        • phone string
        • bookmark string
        • trip_rating number(double)
      • user object

        Additional properties are allowed.

        Hide user attributes Show user attributes object
        • id string
        • name string
        • avatar string
        • role string
        • category string
        • image string
        • rating number(double)
        • phone string
        • bookmark string
        • trip_rating number(double)
      • shared object

        Additional properties are allowed.

        Hide shared attributes Show shared attributes object
        • id integer(int64)
        • category string
        • status string

          Values are ACTIVE, CLOSED, UNFULFILLED, or WAITING.

        • authentication string
        • profile object

          Additional properties are allowed.

          Hide profile attributes Show profile attributes object
          • id string
          • name string
          • avatar string
          • role string
          • category string
          • image string
          • rating number(double)
          • phone string
          • bookmark string
          • trip_rating number(double)
        • timelines array[object]
          Hide timelines attributes Show timelines attributes object
          • status string

            Values are REQUESTED, CANCELLED, CONNECTED, ON_THE_WAY, ARRIVED, AUTHENTICATED, ON_TRIP, SHARE_ACCESS_GRANTED, SHARE_ACCESS_DENIED, LEFT, or COMPLETED.

          • header string
          • description string
          • label string
          • is_over boolean
          • created_at string(date-time)
          • updated_at string(date-time)
        • location object

          Additional properties are allowed.

          Hide location attributes Show location attributes object
          • latitude number(double)
          • longitude number(double)
          • bearing number(double)
          • place string
        • show_cancel boolean
        • show_auth boolean
        • show_end boolean
        • show_share boolean
        • show_grant boolean
        • show_deny boolean
        • show_leave boolean
        • show_notify_on_my_way boolean
        • show_notify_arrival boolean
        • phone_number string
        • first_name string
        • last_name string
        • cancel_reason string
        • is_provider boolean
      • timelines array[object]
        Hide timelines attributes Show timelines attributes object
        • status string

          Values are REQUESTED, CANCELLED, CONNECTED, ON_THE_WAY, ARRIVED, AUTHENTICATED, ON_TRIP, SHARE_ACCESS_GRANTED, SHARE_ACCESS_DENIED, LEFT, or COMPLETED.

        • header string
        • description string
        • label string
        • is_over boolean
        • created_at string(date-time)
        • updated_at string(date-time)
      • quotations array[object]
        Hide quotations attributes Show quotations attributes object
        • id integer(int64)
        • amount string
        • account string
        • name string
        • avatar string
        • rating number(double)
        • distance string
      • authentication string
      • location object

        Additional properties are allowed.

        Hide location attributes Show location attributes object
        • latitude number(double)
        • longitude number(double)
        • bearing number(double)
        • place string
      • show_cancel boolean
      • show_auth boolean
      • show_end boolean
      • show_share boolean
      • show_grant boolean
      • show_deny boolean
      • show_leave boolean
      • show_notify_on_my_way boolean
      • show_notify_arrival boolean
      • requested_id string
      • is_provider boolean
      • waiting_for_quotation_response boolean
      • try_service_payment_again boolean
      • service_fee string
      • user_share_fee string
      • pending_payment_data object

        Additional properties are allowed.

        Hide pending_payment_data attributes Show pending_payment_data attributes object
        • authorization_url string
        • access_code string
        • reference string
      • try_payment_again boolean
      • shopping_location object

        Additional properties are allowed.

        Hide shopping_location attributes Show shopping_location attributes object
        • address string
        • latitude number(double)
        • longitude number(double)
        • place_id string
      • shopping_items array[object]
        Hide shopping_items attributes Show shopping_items attributes object
        • id integer(int64)
        • item string
        • quantity integer(int32)
        • amount string
        • slip string
      • total_amount integer(int32)
      • total_shopping_amount string
      • total_amount_spent_in_shopping string
      • created_at string(date-time)
      • updated_at string(date-time)
POST /trip/request
curl \
 --request POST 'https://sandbox.serchservice.com/api/v1/trip/request' \
 --header "Content-Type: application/json" \
 --data '{"address":"string","latitude":42.0,"longitude":42.0,"provider":"string","category":"MECHANIC","audio":{"path":"string","media":"string","bytes":"string"},"problem":"string","car":"string","amount":42,"place_id":"string","shopping_location":{"address":"string","latitude":42.0,"longitude":42.0,"place_id":"string"},"shopping_items":[{"item":"string","amount":42,"quantity":42}]}'
Request examples
{
  "address": "string",
  "latitude": 42.0,
  "longitude": 42.0,
  "provider": "string",
  "category": "MECHANIC",
  "audio": {
    "path": "string",
    "media": "string",
    "bytes": "string"
  },
  "problem": "string",
  "car": "string",
  "amount": 42,
  "place_id": "string",
  "shopping_location": {
    "address": "string",
    "latitude": 42.0,
    "longitude": 42.0,
    "place_id": "string"
  },
  "shopping_items": [
    {
      "item": "string",
      "amount": 42,
      "quantity": 42
    }
  ]
}
Response examples (200)
{
  "status": "100 CONTINUE",
  "code": 42,
  "message": "string",
  "data": {
    "id": "string",
    "mode": "string",
    "snt": "string",
    "skill": "string",
    "car": "string",
    "category": "string",
    "image": "string",
    "audio": "string",
    "problem": "string",
    "amount": "string",
    "address": "string",
    "placeId": "string",
    "latitude": 42.0,
    "longitude": 42.0,
    "label": "string",
    "status": "ACTIVE",
    "type": "REQUEST",
    "provider": {
      "id": "string",
      "name": "string",
      "avatar": "string",
      "role": "string",
      "category": "string",
      "image": "string",
      "rating": 42.0,
      "phone": "string",
      "bookmark": "string",
      "trip_rating": 42.0
    },
    "user": {
      "id": "string",
      "name": "string",
      "avatar": "string",
      "role": "string",
      "category": "string",
      "image": "string",
      "rating": 42.0,
      "phone": "string",
      "bookmark": "string",
      "trip_rating": 42.0
    },
    "shared": {
      "id": 42,
      "category": "string",
      "status": "ACTIVE",
      "authentication": "string",
      "profile": {
        "id": "string",
        "name": "string",
        "avatar": "string",
        "role": "string",
        "category": "string",
        "image": "string",
        "rating": 42.0,
        "phone": "string",
        "bookmark": "string",
        "trip_rating": 42.0
      },
      "timelines": [
        {
          "status": "REQUESTED",
          "header": "string",
          "description": "string",
          "label": "string",
          "is_over": true,
          "created_at": "2025-05-04T09:42:00Z",
          "updated_at": "2025-05-04T09:42:00Z"
        }
      ],
      "location": {
        "latitude": 42.0,
        "longitude": 42.0,
        "bearing": 42.0,
        "place": "string"
      },
      "show_cancel": true,
      "show_auth": true,
      "show_end": true,
      "show_share": true,
      "show_grant": true,
      "show_deny": true,
      "show_leave": true,
      "show_notify_on_my_way": true,
      "show_notify_arrival": true,
      "phone_number": "string",
      "first_name": "string",
      "last_name": "string",
      "cancel_reason": "string",
      "is_provider": true
    },
    "timelines": [
      {
        "status": "REQUESTED",
        "header": "string",
        "description": "string",
        "label": "string",
        "is_over": true,
        "created_at": "2025-05-04T09:42:00Z",
        "updated_at": "2025-05-04T09:42:00Z"
      }
    ],
    "quotations": [
      {
        "id": 42,
        "amount": "string",
        "account": "string",
        "name": "string",
        "avatar": "string",
        "rating": 42.0,
        "distance": "string"
      }
    ],
    "authentication": "string",
    "location": {
      "latitude": 42.0,
      "longitude": 42.0,
      "bearing": 42.0,
      "place": "string"
    },
    "show_cancel": true,
    "show_auth": true,
    "show_end": true,
    "show_share": true,
    "show_grant": true,
    "show_deny": true,
    "show_leave": true,
    "show_notify_on_my_way": true,
    "show_notify_arrival": true,
    "requested_id": "string",
    "is_provider": true,
    "waiting_for_quotation_response": true,
    "try_service_payment_again": true,
    "service_fee": "string",
    "user_share_fee": "string",
    "pending_payment_data": {
      "authorization_url": "string",
      "access_code": "string",
      "reference": "string"
    },
    "try_payment_again": true,
    "shopping_location": {
      "address": "string",
      "latitude": 42.0,
      "longitude": 42.0,
      "place_id": "string"
    },
    "shopping_items": [
      {
        "id": 42,
        "item": "string",
        "quantity": 42,
        "amount": "string",
        "slip": "string"
      }
    ],
    "total_amount": 42,
    "total_shopping_amount": "string",
    "total_amount_spent_in_shopping": "string",
    "created_at": "2025-05-04T09:42:00Z",
    "updated_at": "2025-05-04T09:42:00Z"
  }
}