Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/harshalw2003/BidAuc/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to fetch the details of a specific service category by its name. This is useful when you need to display category information in a job detail view, validate a category name before submitting a job, or retrieve the image path for a particular category. No authentication is required.

Endpoint

POST /category/getOneCategory

Authentication

None required.

Request parameters

categoryName
string
The name of the category to fetch. Must match a categoryName value exactly as returned by GET /category/getAllCategories.

Example request

curl --request POST \
  --url https://api.bidauc.com/category/getOneCategory \
  --header 'Content-Type: application/json' \
  --data '{
    "categoryName": "Plumbing"
  }'

Success response

{
  "success": true,
  "message": "Category was successfully retrieved",
  "category": {
    "_id": "64a0b1c2d3e4f5a6b7c8d9e0",
    "categoryName": "Plumbing",
    "image": "/uploads/categories/plumbing.jpg"
  }
}

Response fields

success
boolean
required
true when the category was found and returned successfully.
message
string
required
A human-readable status message.
category
object
required
The matching category document.

Build docs developers (and LLMs) love