Add Offers

The Voomerr Add Offer API allows users to add an offer. The API accepts various parameters such as user IDs, gig IDs, delivery information, payment information, and more. This API is used to add offers in the Voomerr marketplace.

Endpoint #

The Voomerr Add Offer API endpoint is POST

Request Parameters #

The following parameters are required to add an offer:

Parameter Type Required Description
user_id string Yes The ID of the user adding the offer.
fromUserId string Yes The ID of the user who created the gig.
gig_id string Yes The ID of the gig to which the offer is being made.
delivery_lat float Yes The latitude of the delivery location.
delivery_long float Yes The longitude of the delivery location.
delivery_address string Yes The address of the delivery location.
required_time string Yes The time at which the delivery is required.
delivery_type string Yes The type of delivery, such as “normal” or “express”.
card_id string No The ID of the payment card to be used for payment.
amount float Yes The amount to be paid for the gig.
currency string Yes The currency in which the payment will be made.
transportation_cost float No The cost of transportation to be paid.
product_ids string No The IDs of the products to be delivered.
is_buynow boolean Yes A flag indicating whether the offer is for a “buy now” gig.

Example Request #

"user_id": "123456789",
"fromUserId": "987654321",
"gig_id": "G1234567",
"delivery_lat": 37.7749,
"delivery_long": -122.4194,
"delivery_address": "123 Main Street, San Francisco, CA",
"required_time": "2023-03-15 08:00:00",
"delivery_type": "normal",
"card_id": "C1234567",
"amount": 100.00,
"currency": "USD",
"transportation_cost": 10.00,
"product_ids": "P12345,P67890",
"is_buynow": false

Response #

The response from the API will contain a JSON object with the following fields:

Field Type Description
success boolean Whether the request was successful or not.
message string A message indicating the success or failure of the request.
offer_id string The ID of the offer that was created.

If the request is successful, the ‘success’ field will be ‘true’, the ‘message’ field will contain a success message indicating that the offer was successfully created, and the ‘offer_id’ field will contain the ID of the offer that was created. If the request fails, the ‘success’ field will be ‘false’, and the ‘message’ field will contain an error message indicating that the creation of the offer has failed.

Example Response #

"success": true,
"message": "Offer created successfully"

Powered by BetterDocs