# Data migration API

You can use the PHP API to manage and run [data migrations](https://doc.ibexa.co/en/latest/content_management/data_migration/data_migration/index.md).

## Getting migration information

To list all migration files available in the directory defined in configuration (by default, `src/Migrations/Ibexa`), use the `MigrationService:listMigrations()` method:

```
        foreach ($this->migrationService->listMigrations() as $migration) {
            $output->writeln($migration->getName());
        }
```

To get a single migration file by its name, use the `MigrationService:findOneByName()` method:

```
        $my_migration = $this->migrationService->findOneByName($migration_name);
```

## Running migration files

To run migration file(s), use either `MigrationService:executeOne()` or `MigrationService:executeAll()`:

```
        $this->migrationService->executeOne($my_migration);
        $this->migrationService->executeAll('admin');
```

Both `executeOne()` and `executeAll()` can take an optional parameter: the login of the User that you want to execute the migrations as.

## Adding new migrations

To add a new migration file, use the `MigrationService:add()` method:

```
        $this->migrationService->add(
            new Migration(
                'new_migration.yaml',
                $string_with_migration_content
            )
        );
```