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
  
  Values are 100 CONTINUE, 101 SWITCHING_PROTOCOLS, 102 PROCESSING, 103 EARLY_HINTS, 103 CHECKPOINT, 200 OK, 201 CREATED, 202 ACCEPTED, 203 NON_AUTHORITATIVE_INFORMATION, 204 NO_CONTENT, 205 RESET_CONTENT, 206 PARTIAL_CONTENT, 207 MULTI_STATUS, 208 ALREADY_REPORTED, 226 IM_USED, 300 MULTIPLE_CHOICES, 301 MOVED_PERMANENTLY, 302 FOUND, 302 MOVED_TEMPORARILY, 303 SEE_OTHER, 304 NOT_MODIFIED, 305 USE_PROXY, 307 TEMPORARY_REDIRECT, 308 PERMANENT_REDIRECT, 400 BAD_REQUEST, 401 UNAUTHORIZED, 402 PAYMENT_REQUIRED, 403 FORBIDDEN, 404 NOT_FOUND, 405 METHOD_NOT_ALLOWED, 406 NOT_ACCEPTABLE, 407 PROXY_AUTHENTICATION_REQUIRED, 408 REQUEST_TIMEOUT, 409 CONFLICT, 410 GONE, 411 LENGTH_REQUIRED, 412 PRECONDITION_FAILED, 413 PAYLOAD_TOO_LARGE, 413 REQUEST_ENTITY_TOO_LARGE, 414 URI_TOO_LONG, 414 REQUEST_URI_TOO_LONG, 415 UNSUPPORTED_MEDIA_TYPE, 416 REQUESTED_RANGE_NOT_SATISFIABLE, 417 EXPECTATION_FAILED, 418 I_AM_A_TEAPOT, 419 INSUFFICIENT_SPACE_ON_RESOURCE, 420 METHOD_FAILURE, 421 DESTINATION_LOCKED, 422 UNPROCESSABLE_ENTITY, 423 LOCKED, 424 FAILED_DEPENDENCY, 425 TOO_EARLY, 426 UPGRADE_REQUIRED, 428 PRECONDITION_REQUIRED, 429 TOO_MANY_REQUESTS, 431 REQUEST_HEADER_FIELDS_TOO_LARGE, 451 UNAVAILABLE_FOR_LEGAL_REASONS, 500 INTERNAL_SERVER_ERROR, 501 NOT_IMPLEMENTED, 502 BAD_GATEWAY, 503 SERVICE_UNAVAILABLE, 504 GATEWAY_TIMEOUT, 505 HTTP_VERSION_NOT_SUPPORTED, 506 VARIANT_ALSO_NEGOTIATES, 507 INSUFFICIENT_STORAGE, 508 LOOP_DETECTED, 509 BANDWIDTH_LIMIT_EXCEEDED, 510 NOT_EXTENDED, or 511 NETWORK_AUTHENTICATION_REQUIRED.
- 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"
  }
}