> ## Documentation Index
> Fetch the complete documentation index at: https://developers.tarefy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retorna batidas geolocalizadas da equipe para visualização em mapa



## OpenAPI

````yaml /api-reference/tempo.yaml get /v2/time-clock/management/map-punches
openapi: 3.0.0
info:
  title: Tarefy API
  description: >-
    Tarefy REST API — task management, culture and performance platform.


    Endpoints are versioned at `/v2/...`. Authentication via Bearer JWT in the
    `Authorization` header.


    To get started, see the [authentication guide](/authentication) and the
    [quickstart](/quickstart).
  version: 2.0.0
  contact:
    name: Tarefy Support
    email: suporte@tarefy.com
    url: https://tarefy.com
  license:
    name: Proprietary
    url: https://tarefy.com
servers:
  - url: https://app.tarefy.com/nodeapi
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Time Clock
    description: Electronic time — work record
  - name: Time Clock Justifys
    description: Time justifications
  - name: Time Bank
    description: Time bank
  - name: Off Time
    description: Days off and absences
  - name: Vacations
    description: Vacation — granting and management
paths:
  /v2/time-clock/management/map-punches:
    get:
      tags:
        - Time Clock
      summary: Retorna batidas geolocalizadas da equipe para visualização em mapa
      parameters:
        - in: query
          name: startDate
          schema:
            type: string
            format: date
            example: '2026-06-10'
          description: Data inicial do período. Quando omitida, usa o dia atual.
        - in: query
          name: endDate
          schema:
            type: string
            format: date
            example: '2026-06-12'
          description: Data final do período. Quando omitida, usa a data inicial.
        - in: query
          name: userId
          schema:
            type: integer
            example: 990
          description: Filtra por colaborador com jornada ativa.
        - in: query
          name: status
          schema:
            type: string
            enum:
              - all
              - inside
              - outside
              - remote
              - exempt
            example: outside
          description: Filtra pelo status de geofence. Default all.
      responses:
        '200':
          description: Batidas geolocalizadas retornadas com sucesso
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    entry_id:
                      type: integer
                      example: 123
                    user:
                      type: object
                      properties:
                        id:
                          type: integer
                          example: 990
                        name:
                          type: string
                          example: Maria Silva
                        photo:
                          type: string
                          nullable: true
                        email:
                          type: string
                          nullable: true
                          example: maria@tarefy.com
                    date:
                      type: string
                      example: '2026-06-10'
                    time:
                      type: string
                      example: '09:00'
                    punched_at:
                      type: string
                      example: '2026-06-16T09:00:00.000Z'
                    type:
                      type: string
                      example: ENTRADA
                    type_label:
                      type: string
                      example: Entrada
                    latitude:
                      type: number
                      example: -23.5617
                    longitude:
                      type: number
                      example: -46.6254
                    accuracy_meters:
                      type: integer
                      nullable: true
                      example: 12
                    distance_meters:
                      type: integer
                      nullable: true
                      example: 180
                    geofence_status:
                      type: string
                      nullable: true
                      example: outside
                    geofence_reference:
                      type: object
                      nullable: true
                      properties:
                        latitude:
                          type: number
                          example: -23.6190278
                        longitude:
                          type: number
                          example: -46.6995833
                        address:
                          type: string
                          nullable: true
                          example: Sede Tarefy
                    address:
                      type: string
                      nullable: true
                      example: Rua Teste, 123
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````