---
agentTools:
  projectIndex: https://developers.pipe.run/llms.txt
---

# Buscar atividade

Busca por uma atividade específica por ID na conta.

## ⚠️  Atenção!

* É importante que veja as possibilidades de busca de relacionamentos.

### Listagem de atributos possíveis de realizar um relacionamento com o parâmetro `with`

Com este parâmetro é possível buscar entidades relacionadas ao registro que buscamos.

> deal\
> owner\
> requester\
> activityType\
> persons\
> companies\
> pipeline\
> stage

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "application/json",
    "version": "1.1-CRM"
  },
  "servers": [
    {
      "url": "https://api.pipe.run/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "token",
        "in": "header"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/activities/{id}": {
      "get": {
        "summary": "Buscar atividade",
        "description": "Busca por uma atividade específica por ID na conta.",
        "operationId": "buscar-atividade",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "ID da atividade.",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"success\": true,\n    \"message\": \"OK\",\n    \"data\": [\n        {\n            \"id\": 11686669,\n            \"status\": 0,\n            \"appointment_id\": null,\n            \"activity_type_id\": 55771,\n            \"owner_id\": 34270,\n            \"account_id\": 8457,\n            \"deal_id\": 11076387,\n            \"time_utilized\": null,\n            \"time_estimated\": null,\n            \"duration\": 30,\n            \"priority\": 3,\n            \"type\": 1,\n            \"requester_id\": 34270,\n            \"title\": \"Atividade de Follow\",\n            \"description\": \"Atividade de Follow\",\n            \"hash\": \"210823061452\",\n            \"comment\": null,\n            \"appearin_link\": null,\n            \"order\": null,\n            \"lat\": 0,\n            \"lng\": 0,\n            \"google_calendar_id\": null,\n            \"outlook_calendar_id\": null,\n            \"delivery_date\": null,\n            \"start_at\": \"2021-08-24 14:00:00\",\n            \"end_at\": \"2021-08-24 14:30:00\",\n            \"internal_date\": null,\n            \"created_at\": \"2021-08-23 18:02:46\",\n            \"updated_at\": \"2021-08-23 18:02:46\",\n            \"companies\": [\n                {\n                    \"id\": 5332635,\n                    \"account_id\": 8457,\n                    \"cnae_id\": 640,\n                    \"city_id\": 4904,\n                    \"manager_id\": 34270,\n                    \"segment_id\": 96645,\n                    \"name\": \"CRM PipeRun\",\n                    \"cnpj\": \"08.692.236/0001-48\",\n                    \"website\": \"https://crmpiperun.com/\",\n                    \"email_nf\": null,\n                    \"logo\": null,\n                    \"hash\": \"c5i1tfh5hcg844g0s4wowc0cc0wsgoo\",\n                    \"observation\": null,\n                    \"address_postal_code\": \"90560-002\",\n                    \"address\": \"AV CRISTOVAO COLOMBO\",\n                    \"address_number\": \"2948\",\n                    \"address_complement\": \"SALA 714\",\n                    \"company_name\": \"ODIG - SOLUCOES DIGITAIS LTDA\",\n                    \"ie\": null,\n                    \"district\": \"FLORESTA\",\n                    \"country\": null,\n                    \"facebook\": \"https://www.facebook.com/piperuncrm\",\n                    \"linkedin\": \"https://www.linkedin.com/company/piperun-crm/\",\n                    \"cep\": \"90560-002\",\n                    \"company_type\": null,\n                    \"company_status\": null,\n                    \"company_situation\": 1,\n                    \"status_touch\": null,\n                    \"nps_score\": null,\n                    \"social_capital\": 10000,\n                    \"legal_nature\": null,\n                    \"lat\": \"-30.017794\",\n                    \"lng\": \"-51.195398\",\n                    \"status\": true,\n                    \"external_code\": null,\n                    \"foreign_contact\": 0,\n                    \"size\": \"EMPRESA DE PEQUENO PORTE\",\n                    \"customer_at\": null,\n                    \"foundation_at\": \"2007-02-13\",\n                    \"updated_at\": \"2021-03-06 20:27:26\",\n                    \"created_at\": \"2021-03-06 17:03:35\",\n                    \"is_brand\": true,\n                    \"is_supplier\": true,\n                    \"is_client\": true,\n                    \"is_carrier\": true,\n                    \"is_franchise\": true,\n                    \"is_channel\": false,\n                    \"owner_id\": null,\n                    \"manager_field_sales_id\": null,\n                    \"is_distributor\": false,\n                    \"is_manufacturer\": false,\n                    \"is_partner\": false\n                }\n            ]\n        }\n    ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    },
                    "message": {
                      "type": "string",
                      "example": "OK"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "example": 11686669,
                            "default": 0
                          },
                          "status": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "appointment_id": {},
                          "activity_type_id": {
                            "type": "integer",
                            "example": 55771,
                            "default": 0
                          },
                          "owner_id": {
                            "type": "integer",
                            "example": 34270,
                            "default": 0
                          },
                          "account_id": {
                            "type": "integer",
                            "example": 8457,
                            "default": 0
                          },
                          "deal_id": {
                            "type": "integer",
                            "example": 11076387,
                            "default": 0
                          },
                          "time_utilized": {},
                          "time_estimated": {},
                          "duration": {
                            "type": "integer",
                            "example": 30,
                            "default": 0
                          },
                          "priority": {
                            "type": "integer",
                            "example": 3,
                            "default": 0
                          },
                          "type": {
                            "type": "integer",
                            "example": 1,
                            "default": 0
                          },
                          "requester_id": {
                            "type": "integer",
                            "example": 34270,
                            "default": 0
                          },
                          "title": {
                            "type": "string",
                            "example": "Atividade de Follow"
                          },
                          "description": {
                            "type": "string",
                            "example": "Atividade de Follow"
                          },
                          "hash": {
                            "type": "string",
                            "example": "210823061452"
                          },
                          "comment": {},
                          "appearin_link": {},
                          "order": {},
                          "lat": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "lng": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "google_calendar_id": {},
                          "outlook_calendar_id": {},
                          "delivery_date": {},
                          "start_at": {
                            "type": "string",
                            "example": "2021-08-24 14:00:00"
                          },
                          "end_at": {
                            "type": "string",
                            "example": "2021-08-24 14:30:00"
                          },
                          "internal_date": {},
                          "created_at": {
                            "type": "string",
                            "example": "2021-08-23 18:02:46"
                          },
                          "updated_at": {
                            "type": "string",
                            "example": "2021-08-23 18:02:46"
                          },
                          "companies": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "integer",
                                  "example": 5332635,
                                  "default": 0
                                },
                                "account_id": {
                                  "type": "integer",
                                  "example": 8457,
                                  "default": 0
                                },
                                "cnae_id": {
                                  "type": "integer",
                                  "example": 640,
                                  "default": 0
                                },
                                "city_id": {
                                  "type": "integer",
                                  "example": 4904,
                                  "default": 0
                                },
                                "manager_id": {
                                  "type": "integer",
                                  "example": 34270,
                                  "default": 0
                                },
                                "segment_id": {
                                  "type": "integer",
                                  "example": 96645,
                                  "default": 0
                                },
                                "name": {
                                  "type": "string",
                                  "example": "CRM PipeRun"
                                },
                                "cnpj": {
                                  "type": "string",
                                  "example": "08.692.236/0001-48"
                                },
                                "website": {
                                  "type": "string",
                                  "example": "https://crmpiperun.com/"
                                },
                                "email_nf": {},
                                "logo": {},
                                "hash": {
                                  "type": "string",
                                  "example": "c5i1tfh5hcg844g0s4wowc0cc0wsgoo"
                                },
                                "observation": {},
                                "address_postal_code": {
                                  "type": "string",
                                  "example": "90560-002"
                                },
                                "address": {
                                  "type": "string",
                                  "example": "AV CRISTOVAO COLOMBO"
                                },
                                "address_number": {
                                  "type": "string",
                                  "example": "2948"
                                },
                                "address_complement": {
                                  "type": "string",
                                  "example": "SALA 714"
                                },
                                "company_name": {
                                  "type": "string",
                                  "example": "ODIG - SOLUCOES DIGITAIS LTDA"
                                },
                                "ie": {},
                                "district": {
                                  "type": "string",
                                  "example": "FLORESTA"
                                },
                                "country": {},
                                "facebook": {
                                  "type": "string",
                                  "example": "https://www.facebook.com/piperuncrm"
                                },
                                "linkedin": {
                                  "type": "string",
                                  "example": "https://www.linkedin.com/company/piperun-crm/"
                                },
                                "cep": {
                                  "type": "string",
                                  "example": "90560-002"
                                },
                                "company_type": {},
                                "company_status": {},
                                "company_situation": {
                                  "type": "integer",
                                  "example": 1,
                                  "default": 0
                                },
                                "status_touch": {},
                                "nps_score": {},
                                "social_capital": {
                                  "type": "integer",
                                  "example": 10000,
                                  "default": 0
                                },
                                "legal_nature": {},
                                "lat": {
                                  "type": "string",
                                  "example": "-30.017794"
                                },
                                "lng": {
                                  "type": "string",
                                  "example": "-51.195398"
                                },
                                "status": {
                                  "type": "boolean",
                                  "example": true,
                                  "default": true
                                },
                                "external_code": {},
                                "foreign_contact": {
                                  "type": "integer",
                                  "example": 0,
                                  "default": 0
                                },
                                "size": {
                                  "type": "string",
                                  "example": "EMPRESA DE PEQUENO PORTE"
                                },
                                "customer_at": {},
                                "foundation_at": {
                                  "type": "string",
                                  "example": "2007-02-13"
                                },
                                "updated_at": {
                                  "type": "string",
                                  "example": "2021-03-06 20:27:26"
                                },
                                "created_at": {
                                  "type": "string",
                                  "example": "2021-03-06 17:03:35"
                                },
                                "is_brand": {
                                  "type": "boolean",
                                  "example": true,
                                  "default": true
                                },
                                "is_supplier": {
                                  "type": "boolean",
                                  "example": true,
                                  "default": true
                                },
                                "is_client": {
                                  "type": "boolean",
                                  "example": true,
                                  "default": true
                                },
                                "is_carrier": {
                                  "type": "boolean",
                                  "example": true,
                                  "default": true
                                },
                                "is_franchise": {
                                  "type": "boolean",
                                  "example": true,
                                  "default": true
                                },
                                "is_channel": {
                                  "type": "boolean",
                                  "example": false,
                                  "default": true
                                },
                                "owner_id": {},
                                "manager_field_sales_id": {},
                                "is_distributor": {
                                  "type": "boolean",
                                  "example": false,
                                  "default": true
                                },
                                "is_manufacturer": {
                                  "type": "boolean",
                                  "example": false,
                                  "default": true
                                },
                                "is_partner": {
                                  "type": "boolean",
                                  "example": false,
                                  "default": true
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "404",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"success\": false,\n  \"message\": \"Not Found\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": false,
                      "default": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Not Found"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "686d5ab389846000619e863f:686d5ab389846000619e864f"
}
```